> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.ripio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Balances

> Returns wallet balances (on-chain/fiat) and viral balances (DEX tokens) for the authenticated user.

Wallet balances include available amount, and locked amount per currency.

---

**Authorization**

- Requires a valid API key.



## OpenAPI

````yaml get /wallet/balance/
openapi: 3.0.0
info:
  title: Ripio Gateway
  description: Ripio API - Services documentation.
  version: 0.1.0
  x-logo:
    url: https://cwstatic.nyc3.digitaloceanspaces.com/1996/bitcointrade.png
servers:
  - url: https://api.ripio.com
    description: Production environment
security: []
paths:
  /wallet/balance/:
    get:
      tags:
        - Ripio Wallet
      summary: balances - Get balances
      description: >-
        Returns wallet balances (on-chain/fiat) and viral balances (DEX tokens)
        for the authenticated user.


        Wallet balances include available amount, and locked amount per
        currency.


        ---


        **Authorization**


        - Requires a valid API key.
      parameters:
        - in: header
          name: authorization
          required: true
          description: The API key as a string.
          schema:
            type: string
        - in: header
          name: signature
          required: true
          description: >-
            See the [Generating
            Signature](/static/api/authentication#generating-signature) section
            for more details.
          schema:
            type: string
        - in: header
          name: timestamp
          required: true
          description: >-
            A timestamp in milliseconds. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
        - in: header
          name: timstamp-tolerance
          required: false
          description: >-
            An additional, non-required parameter, that you can send to specify
            the number of milliseconds after the timestamp for the request to be
            valid. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: Balances retrieved successfully.
                properties:
                  error_code:
                    type: string
                    example: null
                  message:
                    type: string
                    example: null
                  data:
                    properties:
                      wallet:
                        description: On-chain and fiat balances.
                        items:
                          properties:
                            currency:
                              description: Currency code (e.g. BTC, ETH, ARS).
                              type: string
                              example: BTC
                            currency_internal_id:
                              description: Internal Ripio currency ID.
                              type: integer
                              example: 1
                            amount:
                              description: Available balance as a decimal string.
                              type: string
                              example: '0.05000000'
                            locked_amount:
                              description: >-
                                Locked balance (reserved for open orders) as a
                                decimal string.
                              type: string
                              example: '0.00000000'
                          required:
                            - currency
                            - currency_internal_id
                            - amount
                            - locked_amount
                          type: object
                        type: array
                      virals:
                        description: DEX viral token positions.
                        items:
                          type: object
                        type: array
                    required:
                      - wallet
                    type: object
                required:
                  - error_code
                  - message
                  - data
                type: object
                example:
                  error_code: null
                  message: null
                  data:
                    wallet:
                      - currency: BTC
                        currency_internal_id: 1
                        amount: '0.05000000'
                        locked_amount: '0.00000000'
                    virals: []
        '401':
          description: Error response 401
        '403':
          description: Error response 403

````