> ## 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.

# Get Balance

> GET /v2/naas/balance — return the sub-merchant's available balances across all asset accounts.

## Response `200 OK`

| Field                  | Type   | Description                           |
| ---------------------- | ------ | ------------------------------------- |
| `balances`             | array  | One entry per asset account           |
| `balances[].currency`  | string | Asset code (e.g. `USDT_ETH`, `BTC`)   |
| `balances[].available` | string | Available balance as a decimal string |

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://checkout.noxpay.io/v2/naas/balance \
    -H "api-key: <key>" \
    -H "X-Timestamp: 2026-05-27T14:30:00Z" \
    -H "X-Correlation-ID: a1b2c3d4-e5f6-4789-abcd-000000000001" \
    -H "X-Signature: <signed-headers-signature>"
  ```

  ```python Python theme={null}
  import requests

  headers = sign_get_headers(private_key, "a1b2c3d4-e5f6-4789-abcd-000000000001")
  headers["api-key"] = "<key>"
  response = requests.get(
      "https://checkout.noxpay.io/v2/naas/balance",
      headers=headers,
  )
  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const headers = signGETHeaders("a1b2c3d4-e5f6-4789-abcd-000000000001");
  headers["api-key"] = "<key>";
  const response = await fetch("https://checkout.noxpay.io/v2/naas/balance", {
    method: "GET",
    headers,
  });
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "balances": [
      { "currency": "USDT_ETH", "available": "1250.00" },
      { "currency": "BTC",       "available": "0.04500000" }
    ]
  }
  ```
</ResponseExample>