Wallet Balances

Fetch current token balances for a wallet address.

Native Balance

GET/v1/wallets/{address}/native-balance

Returns the native token balance (ETH, BNB, MATIC, etc.) for the given chain.

Parameter	Type	Description
address*	string	Wallet address
chainoptional	string = ethereum	Chain slug

Response 200 OK

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain": "ethereum",
  "balance": "1234.567890123456789",
  "balance_usd": 4815162.34,
  "block_number": 21950000,
  "timestamp": "2026-04-04T14:30:00Z"
}

All Balances

GET/v1/wallets/{address}/balances

Returns native + all token balances in a single call.

Parameter	Type	Description
address*	string	Wallet address
chainoptional	string	Chain slug. Omit to query all chains (slower).
includeSpamoptional	boolean = false	Include suspected spam/airdrop tokens

Response 200 OK

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain": "ethereum",
  "balances": [
    {
      "asset": "ETH",
      "contractAddress": null,
      "balance": "1234.567890123456789",
      "balance_usd": 4815162.34,
      "type": "native"
    },
    {
      "asset": "USDC",
      "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "balance": "50000.000000",
      "balance_usd": 50000.00,
      "type": "erc20"
    }
  ],
  "total_usd": 4865162.34,
  "block_number": 21950000,
  "timestamp": "2026-04-04T14:30:00Z"
}