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

# Balance

> GET /v2/balance — retrieve your current account balance broken down by currency and sub-account.

## Response `200 OK`

### Response fields

| Field                          | Type   | Description                                            |
| ------------------------------ | ------ | ------------------------------------------------------ |
| `calculated_BRL_total_balance` | float  | Sum of all balances converted to BRL at current rates  |
| `balances`                     | object | Keyed by currency name, then by network or sub-account |

### Sub-account buckets

Each currency entry breaks down into four buckets:

| Field        | Description                                       |
| ------------ | ------------------------------------------------- |
| `available`  | Immediately withdrawable                          |
| `in_transit` | In transit while a transaction is being processed |
| `to_receive` | Expected to arrive from an ongoing transaction    |
| `blocked`    | Frozen for chargebacks or compliance holds        |

`calculated_BRL_balance` at the currency level is the BRL-equivalent sum of all sub-accounts for that currency.

<RequestExample>
  ```bash theme={null}
  curl https://checkout.noxpay.io/v2/balance \
    -H "api-key: <key>"
  ```

  ```python theme={null}
  import requests

  response = requests.get(
      "https://checkout.noxpay.io/v2/balance",
      headers={"api-key": "<key>"},
  )
  print(response.json())
  ```

  ```javascript theme={null}
  const response = await fetch("https://checkout.noxpay.io/v2/balance", {
    headers: { "api-key": "<key>" },
  });
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "calculated_BRL_total_balance": 1234.56,
    "balances": {
      "USDT": {
        "calculated_BRL_balance": 500.00,
        "USDT TRC20": {
          "calculated_BRL_balance": 500.00,
          "available": 100.00,
          "in_transit": 10.00,
          "to_receive": 5.00,
          "blocked": 0.00
        }
      },
      "BRL": {
        "calculated_BRL_balance": 734.56,
        "BRL": {
          "calculated_BRL_balance": 734.56,
          "available": 734.56,
          "in_transit": 0.00,
          "to_receive": 0.00,
          "blocked": 0.00
        }
      }
    }
  }
  ```
</ResponseExample>