Hunt Townh402
Catalog
CryptoPOSTlive

Wallet balances

Get current token balances for a wallet address or named entity on a supported chain.

$0.01
per call
Success
83%
p50 latency
3.29s
p95 latency
14.54s
Calls (30d)
12

Provider contract

Call path
/routes/
nansendefault
/crypto/wallet-balances
Method
POST
Selected provider
nansendefault
Provider price
$0.01
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/nansen/crypto/wallet-balances' \
  -H 'content-type: application/json' \
  -d '{"address":"0x28c6c06298d514db089934071355e5743bf21d60","chain":"ethereum","hide_spam_token":true}'
CLI
h402 call 'crypto/wallet-balances' --provider 'nansen' --method POST --json '{"address":"0x28c6c06298d514db089934071355e5743bf21d60","chain":"ethereum","hide_spam_token":true}'

Parameters & live test

pays real USDC
nansendefault$0.010/call

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

addressstringoptional *

Wallet address to get balances for. Provide either walletAddress or entityName.

e.g.
entity_namestringoptional *

Nansen entity name to get balances for. Provide either walletAddress or entityName.

e.g.
chainstringrequired

Nansen chain slug for the balances. Use 'all' to span every supported chain.

One of
hide_spam_tokenbooleanoptionaldefault true

Remove suspicious/spam tokens from the balance list. Defaults to true.

paginationobjectoptional

Optional pagination, e.g. { "page": 1, "perPage": 10 }.

pagination.pageintegeroptional≥ 1

1-based page number.

pagination.per_pageintegeroptional1–1000

Results per page (max 1000).

Provide at least one of address, entity_name.
POST/routes/nansen/crypto/wallet-balances
Request body
{
  "address": "0x28c6c06298d514db089934071355e5743bf21d60",
  "chain": "ethereum",
  "hide_spam_token": true
}

ResponseExample response
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 10,
      "is_last_page": false
    },
    "data": [
      {
        "chain": "ethereum",
        "address": "0x28c6c06298d514db089934071355e5743bf21d60",
        "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "token_symbol": "USDT",
        "token_name": "Tether USD",
        "token_amount": 1100899630.278704,
        "price_usd": 0.999347638393978,
        "value_usd": 1100181445.6278265
      },
      {
        "chain": "ethereum",
        "address": "0x28c6c06298d514db089934071355e5743bf21d60",
        "token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "token_symbol": "ETH",
        "token_name": "Ethereum",
        "token_amount": 210158.4062243252,
        "price_usd": 1929.984030974054,
        "value_usd": 405602367.98790586
      },
      {
        "chain": "ethereum",
        "address": "0x28c6c06298d514db089934071355e5743bf21d60",
        "token_address": "0xa2e3356610840701bdf5611a53974510ae27e2e1",
        "token_symbol": "WBETH",
        "token_name": "Wrapped Binance Beacon ETH",
        "token_amount": 40177.529978592094,
        "price_usd": 2124.2453283891496,
        "value_usd": 85346930.36323926
      }
    ]
  },
  "h402": {
    "routeId": "crypto/wallet-balances",
    "provider": "nansen",
    "selectedCandidateId": "crypto/wallet-balances/nansen",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

nansendefaultcheapest
x402
100
Success
100%
p50
1.58s
Calls
5
100%
$0.01$0.010/call
allium
x402mpp
71
Success
71%
p50
3.52s
Calls
7
71%
$0.01$0.010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider