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

# GET /trading/balances — trading account balances

> Retrieve a breakdown of your trading account balances by asset, including available, locked, and total amounts for each currency.

The balances endpoint gives you a real-time snapshot of your trading account. For each asset held in your account, you receive three figures: the amount available to place new orders, the amount locked in open orders, and the combined total. Use this endpoint before placing orders to confirm you have sufficient funds.

All trading routes require authentication. Pass your API key in the `X-Api-Key` header or a valid JWT in the `Authorization: Bearer` header.

## Request

```bash theme={null}
curl https://api.dubupay.com/api/v1/trading/balances \
  -H "X-Api-Key: dubu_sk_live_YOUR_API_KEY"
```

## Response

A successful response returns `200 OK` with a `data` array containing one object per asset.

<ResponseField name="success" type="boolean">
  Always `true` for successful responses.
</ResponseField>

<ResponseField name="data" type="array">
  List of balance objects, one per asset.

  <Expandable title="Balance object">
    <ResponseField name="asset" type="string">
      The asset ticker, e.g. `USDT`, `USDC`, `NGN`.
    </ResponseField>

    <ResponseField name="available" type="string">
      The amount available to trade or withdraw. Formatted as a decimal string to preserve precision.
    </ResponseField>

    <ResponseField name="locked" type="string">
      The amount currently locked in open or partially-filled orders.
    </ResponseField>

    <ResponseField name="total" type="string">
      The sum of `available` and `locked`. Represents your full holding for this asset.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "asset": "USDT",
      "available": "500.00",
      "locked": "100.00",
      "total": "600.00"
    },
    {
      "asset": "NGN",
      "available": "750000.00",
      "locked": "0.00",
      "total": "750000.00"
    }
  ]
}
```