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

# Consultar Saldo

> GET /v2/naas/balance — retorna os saldos disponíveis do sub-merchant em todas as contas de ativos.

## Response `200 OK`

| Campo                  | Tipo   | Descrição                               |
| ---------------------- | ------ | --------------------------------------- |
| `balances`             | array  | Uma entrada por conta de ativo          |
| `balances[].currency`  | string | Código do ativo (ex: `USDT_ETH`, `BTC`) |
| `balances[].available` | string | Saldo disponível como string decimal    |

<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: <assinatura-dos-headers>"
  ```

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

  # Headers assinados
  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}
  // Headers assinados
  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>