> For the complete documentation index, see [llms.txt](https://vnx.gitbook.io/vnx-global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vnx.gitbook.io/vnx-global/developer/api/balances.md).

# Balances

Read your account balances, fetch a deposit address for an asset on a chain, and list your whitelisted withdrawal addresses.

> **INFO:** Before you begin:

* A signed-request setup. See Authentication.
* All endpoints below are `POST` with `application/x-www-form-urlencoded` bodies.

## Endpoints

| Method | Path                         | Purpose                               |
| ------ | ---------------------------- | ------------------------------------- |
| POST   | `/private/accountBalance`    | List balances per asset               |
| POST   | `/private/depositAddress`    | Get a deposit wallet address          |
| POST   | `/private/withdrawAddresses` | List whitelisted withdrawal addresses |

## Account balance

Send an empty body.

```http
POST /api/v1/private/accountBalance HTTP/1.1Host: api.vnx.ioContent-Type: application/x-www-form-urlencodedUser-Agent: MyClient/1.0x-app-public-key: <public_key>x-app-nonce: 1708881600001x-app-signed-data: <base64url_signature>
```

```json
{  "timestamp": "2026-06-19T09:21:33Z",  "balances": [    { "asset": "VCHF", "available_balance": "100000.00" },    { "asset": "VGBP", "available_balance": "0.00" }  ]}
```

## Deposit address

Pass `asset` and `blockchain`; the response returns a deposit wallet address. Discover valid asset/blockchain pairs from the public `/client/assets` endpoint.

```
asset=VCHF&blockchain=ethereum
```

## Withdraw addresses

Empty or minimal body; returns the addresses whitelisted for your account. Withdrawals can only target a whitelisted address — see Transfers.

## Verify

`/private/accountBalance` returns `200` with a `timestamp` and a `balances` array (empty for a new account).

## Common errors

| `code` / `status`              | Meaning                | Fix                    |
| ------------------------------ | ---------------------- | ---------------------- |
| `400` invalid signature        | Signing inputs wrong   | See Authentication     |
| `400` unknown asset/blockchain | Pair not supported     | Check `/client/assets` |
| `429` rate limited             | Over 1 req/sec per key | Backoff                |

## Next steps

* Transfers
* Quotes and payment rails

## Related

* [API Overview](/vnx-global/developer/api/overview.md)
* [Asset Segregation](/vnx-global/institutional/custody/asset-segregation.md)
* [Glossary](/vnx-global/glossary.md)