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

# Read your USDT balance

> **Scope:** `wallet:read`

`available` is what you can spend now. `reserved` is held by payments that have not finished yet. `top_up_addresses` are your wallet addresses — today one, on Tron. It is created the first time you read your wallet, so there is nothing to create; if the list is ever empty, read it again a moment later. Send **only USDT** on the stated chain. Once a USDT transfer to your top-up address confirms on-chain, we credit it automatically, once per transfer — no call needed. Each transfer shows up in [your transactions](/api-reference/wallet/list-transactions) as an `in` row: `pending` while it confirms, then `completed`, with a `deposit.*` webhook at each step.



## OpenAPI

````yaml api-reference/openapi.json GET /wallets
openapi: 3.0.3
info:
  title: Rampa Pay API
  version: 1.0.0
  description: >-
    Hold a USDT balance at Rampa and pay Bolivian merchant QRs in bolivianos.
    Amounts are decimal strings.
servers:
  - url: https://examples.staging.rampapay.com/v1
    description: 'Example server: sample answers, nothing real moves'
security:
  - apiKey: []
tags:
  - name: Accounts
    description: Every balance you hold with Rampa, in one place.
  - name: Wallet
    description: Your USDT balance at Rampa, and how money gets into it.
  - name: Payouts
    description: >-
      Quote a BOB amount in USDT; once your end user accepts, pay it out at that
      quote from your USDT wallet — to a merchant QR today, to a bank account
      soon.
  - name: Webhooks
    description: Where we send events. Each endpoint gets its own signing secret.
paths:
  /wallets:
    get:
      tags:
        - Wallet
      summary: Read your USDT balance
      description: >-
        **Scope:** `wallet:read`


        `available` is what you can spend now. `reserved` is held by payments
        that have not finished yet. `top_up_addresses` are your wallet addresses
        — today one, on Tron. It is created the first time you read your wallet,
        so there is nothing to create; if the list is ever empty, read it again
        a moment later. Send **only USDT** on the stated chain. Once a USDT
        transfer to your top-up address confirms on-chain, we credit it
        automatically, once per transfer — no call needed. Each transfer shows
        up in [your transactions](/api-reference/wallet/list-transactions) as an
        `in` row: `pending` while it confirms, then `completed`, with a
        `deposit.*` webhook at each step.
      operationId: get-wallet
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  currency:
                    type: string
                  available:
                    type: string
                  reserved:
                    type: string
                  as_of:
                    type: string
                  top_up_addresses:
                    type: array
                    items:
                      type: object
                      properties:
                        chain:
                          type: string
                        address:
                          type: string
              example:
                currency: USDT
                available: '897.960000'
                reserved: '0.000000'
                as_of: '2026-09-27T14:06:40.000Z'
                top_up_addresses:
                  - chain: tron
                    address: TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
components:
  responses:
    Unauthorized:
      description: >-
        `AUTHENTICATION_FAILED` — the key is missing, unknown, revoked or
        expired, or the tenant is suspended.
    Forbidden:
      description: '`SCOPE_REQUIRED` — your key lacks this endpoint''s scope. Ask Rampa.'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        On the example server, any key that starts with `rpk_mock_`, e.g.
        `rpk_mock_yourname`. Never your real key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.