# Token Balances

Returns token balances for a specific wallet address. This endpoint is essential for building trading interfaces, portfolio management tools, and any application that needs to display or verify user token holdings.

**Endpoint:** `GET https://api.liqd.ag/tokens/balances`

**Authentication**: None required - publicly accessible

**Rate Limits**: No rate limits

### Required Parameters

| Name     | Type    | Description                                 | Required |
| -------- | ------- | ------------------------------------------- | -------- |
| `wallet` | address | Address of the wallet to check balances for | Yes      |

### Optional Parameters

| Name    | Type   | Description                        | Default |
| ------- | ------ | ---------------------------------- | ------- |
| `limit` | number | Maximum number of tokens to return | none    |

**Parameter Details:**

* **wallet**: Must be a valid Ethereum-style address (0x followed by 40 hexadecimal characters)
* **limit**: Useful for pagination or when you only need the top token holdings. If not specified, returns all tokens with non-zero balances

**Example Requests:**

```
# Get all token balances for a wallet
GET https://api.liqd.ag/tokens/balances?wallet=0x123456789abcdef123456789abcdef123456789

# Get only the top 10 token holdings
GET https://api.liqd.ag/tokens/balances?wallet=0x123456789abcdef123456789abcdef123456789&limit=10
```

**Example Response:**

```json
{
  "success": true,
  "data": {
    "wallet": "0x123456789abcdef123456789abcdef123456789",
    "tokens": [
      {
        "token": "Native HYPE",
        "balance": "1000000000000000000",
        "name": "HYPE",
        "symbol": "HYPE",
        "decimals": 18
      },
      {
        "token": "0x47bb061C0204Af921F43DC73C7D7768d2672DdEE",
        "balance": "500000000000000000",
        "name": "Token One",
        "symbol": "TOKEN1",
        "decimals": 18
      }
    ],
    "count": 2,
    "limitedCount": 2
  }
}
```