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

# Balances

> Read the current balances of an account and interpret the price and USD value fields.

Read an account's holdings for portfolio displays, a customer's balance screen, reconciliation, or a pre-trade check. One call returns every asset the account holds, with a recent USD value for each, so you can show a customer what they own without pricing it yourself.

## What's available

| Action | Status | Notes |
| :- | :- | :- |
| List current balances | Live | |
| Balances as of a past instant | Under construction | The `asOf` parameter is in the reference but returns `400` today |

***

## Integration steps

### Step 1: List balances

**`GET /v4/accounts/{accountId}/balances`**

Returns one entry per asset the account holds. Page with `limit` and `after`.

`accountId` is the account whose balances you want. A segregated account or a pure omnibus returns its own holdings. An FBO or a per-customer omnibus doesn't hold balances itself, so it returns an empty list; read the accounts under it instead.

```bash Request theme={null}
curl --request GET \
     --url 'https://api.anchorage-staging.com/v4/accounts/cb80459c-a930-444e-8f17-69ba9d0e122f/balances?limit=50' \
     --header 'Api-Access-Key: {API Key}' \
     --header 'accept: application/json'
```

```json Response (200) theme={null}
{
  "data": [
    {
      "accountId": "cb80459c-a930-444e-8f17-69ba9d0e122f",
      "assetType": "BTC",
      "price": "64998.50",
      "amounts": [
        { "balanceType": "TOTAL", "quantity": "10.45234733", "usdValue": "679387.28" },
        { "balanceType": "AVAILABLE_FOR_TRADING", "quantity": "10.45234733", "usdValue": "679387.28" },
        { "balanceType": "AVAILABLE_FOR_WITHDRAWAL", "quantity": "10.20234733", "usdValue": "663138.78" }
      ]
    },
    {
      "accountId": "cb80459c-a930-444e-8f17-69ba9d0e122f",
      "assetType": "USD",
      "price": "1.00",
      "amounts": [
        { "balanceType": "TOTAL", "quantity": "25000.00", "usdValue": "25000.00" },
        { "balanceType": "AVAILABLE_FOR_TRADING", "quantity": "25000.00", "usdValue": "25000.00" },
        { "balanceType": "AVAILABLE_FOR_WITHDRAWAL", "quantity": "25000.00", "usdValue": "25000.00" }
      ]
    }
  ],
  "page": {
    "endCursor": null
  }
}
```

#### Reading the response

| Field | Description |
| :- | :- |
| `assetType` | The asset, as listed by `GET /v4/asset-types` |
| `price` | A recent intraday USD price for one unit of the asset |
| `amounts` | One entry per `balanceType`, each with a `quantity` (decimal string) and a `usdValue` (`quantity × price`, rounded to the cent) |

Each held asset carries three amounts:

| `balanceType` | Meaning |
| :- | :- |
| `TOTAL` | Settled holdings, whether or not part of them is currently encumbered |
| `AVAILABLE_FOR_TRADING` | What can be traded now: unencumbered settled holdings plus pending credits |
| `AVAILABLE_FOR_WITHDRAWAL` | What can be withdrawn now: settled holdings not encumbered by a pending withdrawal or an open order |

> [!NOTE]
>
> `price` and `usdValue` are a convenience for estimating portfolio value at a point in time. They're recent, not real-time, and they aren't the prices Anchorage Digital uses for anything else. Orders carry their own execution prices. Don't build execution logic on these values.

For the activity behind a balance change, see [Transactions](https://docs.anchorage.com/knowledge-base/platform/developers/caas/caas-transactions.md). For an end-of-day snapshot of every position as a file, see [Reconciliation files](https://docs.anchorage.com/knowledge-base/platform/developers/caas/caas-reconciliation-files.md).


## Related topics

- [Reading balances](https://docs.anchorage.com/knowledge-base/platform/users/reading-balances.md)
- [List balances](https://docs.anchorage.com/knowledge-base/api-reference/v4/balances/list-balances.md)
- [Get Wallet Balances](https://docs.anchorage.com/knowledge-base/porto/api-reference/v3/balances/get-wallet-balances.md)
- [Get vesting balances](https://docs.anchorage.com/knowledge-base/porto/api-reference/v2/vesting-balances-batch.md)
