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

# Query Account Balance

> Retrieve token balance information for an account

### Endpoint

**GET** `/v1/account/balance`

### Request Parameters

| Parameter     | Type   | Required | Description                      |
| ------------- | ------ | -------- | -------------------------------- |
| **timestamp** | `Long` | Yes      | UNIX timestamp (in milliseconds) |

### Response Parameters

| Parameter     | Type     | Required | Description       |
| ------------- | -------- | -------- | ----------------- |
| **tokenName** | `String` | Yes      | Token name        |
| **free**      | `String` | Yes      | Available balance |
| **freeze**    | `String` | Yes      | Frozen balance    |

### Response Example

```json theme={null}
{
    "code": 200,
    "msg": "success",
    "timestamp": "1725853044217",
    "data": [
        {
            "tokenName": "USDT",
            "free": "1262.1129",
            "freeze": "0.00"
        },
        {
            "tokenName": "TRX",
            "free": "873.3",
            "freeze": "0.00"
        }
    ]
}
```