Skip to main content
GET
/
v1
/
wallet
/
{address}
/
balances
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.0xradar.app/v1/wallet/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances?chain=ethereum&max_tokens=5"

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "chain": "ethereum",
  "native": {
    "symbol": "ETH",
    "balance": "5.676920964456558449",
    "price_usd": "2062.09",
    "value_usd": "11706.32"
  },
  "tokens": [
    {
      "contract": "0x...",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "balance": "1500",
      "price_usd": "1.00",
      "value_usd": "1500"
    }
  ],
  "token_count_total": 57,
  "token_count_shown": 5,
  "total_value_usd": "13206.32",
  "timestamp": "2026-05-27T05:00:00.000000"
}

Documentation Index

Fetch the complete documentation index at: https://docs.0xradar.app/llms.txt

Use this file to discover all available pages before exploring further.

Returns native + ERC-20 token balances for a single wallet address on one chain.

​
Auth

Optional X-API-Key header (free tier limited to 10 tokens per call).

​
Path parameters

​
address
string
required
EVM wallet address (42-character hex).

​
Query parameters

​
chain
string
default:"ethereum"
required
One of: ethereum, arbitrum, base, optimism, polygon, bsc, hyperevm
​
include_prices
boolean
default:"true"
Whether to enrich tokens with USD prices.
​
max_tokens
integer
default:"20"
Maximum tokens to return. Max 100 (Alchemy provider limit).

​
Response fields

​
address
string
Queried wallet address (lowercased)
​
chain
string
Chain identifier
​
native
object
Native token balance + price
​
tokens
object[]
ERC-20 holdings with metadata + USD prices
​
total_value_usd
string
Sum of all USD values
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.0xradar.app/v1/wallet/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances?chain=ethereum&max_tokens=5"

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "chain": "ethereum",
  "native": {
    "symbol": "ETH",
    "balance": "5.676920964456558449",
    "price_usd": "2062.09",
    "value_usd": "11706.32"
  },
  "tokens": [
    {
      "contract": "0x...",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "balance": "1500",
      "price_usd": "1.00",
      "value_usd": "1500"
    }
  ],
  "token_count_total": 57,
  "token_count_shown": 5,
  "total_value_usd": "13206.32",
  "timestamp": "2026-05-27T05:00:00.000000"
}