# GET /balances/address/{address}

**Operation ID:** `GetAddressBalances`

Get token balances for an address

Returns token balances for the specified address, optionally filtered by chains.

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `chains` | query | array | No | Chains to filter by, as a single comma-separated value (e.g. 'ethereum,bsc'). If omitted, returns balances across all supported chains. Example: `["ethereum","bsc","polygon"]` |
| `address` | path | string | Yes | The blockchain address to query balances for. Example: `"0x28C6c06298d514Db089934071355E5743bf21d60"` |

## Responses

- **200**: OK
  **Schema**: ([GetAddressBalancesResponse](https://arkm.com/llms/schemas/GetAddressBalancesResponse.md))

**Example:**
```json
{
  "addresses": {
    "bsc": {
      "0x28C6c06298d514Db089934071355E5743bf21d60": {
        "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
        "arkhamEntity": {
          "crunchbase": "https://www.crunchbase.com/organization/binance",
          "id": "binance",
          "linkedin": "https://www.linkedin.com/company/binance",
          "name": "Binance",
          "note": "",
          "service": null,
          "twitter": "https://twitter.com/binance",
          "type": "cex",
          "website": "https://binance.com"
        },
        "arkhamLabel": {
          "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
          "chainType": "evm",
          "name": "Hot Wallet"
        },
        "chain": "bsc",
        "contract": false,
        "isUserAddress": false
      }
    },
    "ethereum": {
      "0x28C6c06298d514Db089934071355E5743bf21d60": {
        "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
        "arkhamEntity": {
          "crunchbase": "https://www.crunchbase.com/organization/binance",
          "id": "binance",
          "linkedin": "https://www.linkedin.com/company/binance",
          "name": "Binance",
          "note": "",
          "service": null,
          "twitter": "https://twitter.com/binance",
          "type": "cex",
          "website": "https://binance.com"
        },
        "arkhamLabel": {
          "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
          "chainType": "evm",
          "name": "Hot Wallet"
        },
        "chain": "ethereum",
        "contract": false,
        "isUserAddress": false
      }
    }
  },
  "balances": {
    "bsc": [
      {
        "balance": 3734.2858510100004,
        "balanceExact": "3734285851010000000000",
        "ethereumAddress": "0x55d398326f99059fF775485246999027B3197955",
        "id": "binance-bridged-usdt-bnb-smart-chain",
        "name": "Tether USD",
        "price": 1,
        "priceChange24h": 0,
        "priceChange24hPercent": 0,
        "quoteTime": "2026-07-06T08:56:06.003Z",
        "symbol": "USDT",
        "usd": 3734.2858510100004
      }
    ],
    "ethereum": [
      {
        "balance": 933180509.069545,
        "balanceExact": "933180509069545",
        "ethereumAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "id": "tether",
        "name": "Tether USD",
        "price": 1,
        "priceChange24h": 0,
        "priceChange24hPercent": 0,
        "quoteTime": "2026-07-06T08:56:21.074Z",
        "symbol": "USDT",
        "usd": 933180509.069545
      },
      {
        "balance": 264229.89222968067,
        "balanceExact": "264229892229680683921876",
        "id": "ethereum",
        "name": "Ethereum",
        "price": 1764.02,
        "priceChange24h": -2.2200000000000273,
        "priceChange24hPercent": -0.12569073285623852,
        "quoteTime": "2026-07-06T08:56:12.855Z",
        "symbol": "ETH",
        "usd": 466106814.4910013
      }
    ]
  },
  "totalBalance": {
    "bsc": 4958.963746508313,
    "ethereum": 1851859770.8709288
  },
  "totalBalance24hAgo": {
    "bsc": 4962.53510092634,
    "ethereum": 1855389918.2681246
  }
}
```
- **400**: Bad Request
- **500**: Internal Server Error

## Example

```bash
curl -X GET "https://api.arkm.com/balances/address/0x28C6c06298d514Db089934071355E5743bf21d60?chains=ethereum,bsc,polygon" \
  -H "API-Key: YOUR_API_KEY"
```
