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

# Balances

## Get Balances

```http theme={null}
GET /api/v1/balance
```

| Parameter | Type | Required | Description |
| - | - | - | - |
| `address` | string | yes | Bech32 or EVM hex account address |

```bash theme={null}
curl "https://am-api.cloud.aultblockchain.xyz/api/v1/balance?address=ault1..."
```

Returns `free`, `used`, and `total` dictionaries keyed by currency code, plus a flat per-currency
entry at the top level.

```json theme={null}
{
  "AULT": { "free": "288241.836723361260830223", "used": "0", "total": "288241.836723361260830223" },
  "USDC": { "free": "7953.192574269846524481", "used": "0", "total": "7953.192574269846524481" },
  "free":  { "AULT": "288241.836723361260830223", "USDC": "7953.192574269846524481" },
  "used":  { "AULT": "0", "USDC": "0" },
  "total": { "AULT": "288241.836723361260830223", "USDC": "7953.192574269846524481" },
  "timestamp": null,
  "datetime": null,
  "info": {}
}
```

| Field | Description |
| - | - |
| `free` | Usable balance |
| `used` | Held in escrow against resting orders |
| `total` | `free` plus `used` |

An invalid address returns `400 BAD_REQUEST`.

## Notes

* An order rejected for insufficient funds was checked against `free`, not `total`.
* These are Ault Core balances. Balances on Ault EVM are separate. See
  [Transfer Assets](https://docs.aultblockchain.com/dex-api/trading/transfer-assets.md).
* For live balance changes, subscribe to the `spotState` channel on
  [Subscriptions](https://docs.aultblockchain.com/dex-api/websocket/subscriptions.md) instead of polling.


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