Hunt Townh402
Catalog
CryptoPOSTlive

Wallet balance history

Get historical token balance snapshots for a wallet address or named entity over a date range.

$0.01
per call
Success
100%
p50 latency
3.11s
p95 latency
5.08s
Calls (30d)
11

Provider contract

Call path
/routes/
nansendefault
/crypto/wallet-balance-history
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-balance-history' \
  -H 'content-type: application/json' \
  -d '{"address":"0x28c6c06298d514db089934071355e5743bf21d60","chain":"ethereum","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'
CLI
h402 call 'crypto/wallet-balance-history' --provider 'nansen' --method POST --json '{"address":"0x28c6c06298d514db089934071355e5743bf21d60","chain":"ethereum","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'

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 historical balances for. Provide either walletAddress or entityName.

e.g.
entity_namestringoptional *

Optional Nansen entity name to look up instead of a wallet address (Nansen-only; pin the nansen candidate to use it on the aggregated route).

e.g.
chainstringrequired

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

One of
dateobjectrequired

ISO 8601 date-time range for the historical snapshots, with from and to fields.

date.fromstringrequired

Inclusive range start.

e.g.
date.tostringrequired

Inclusive range end.

e.g.
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-balance-history
Request body
{
  "address": "0x28c6c06298d514db089934071355e5743bf21d60",
  "chain": "ethereum",
  "date": {
    "from": "2026-05-15T00:00:00Z",
    "to": "2026-05-21T23:59:59Z"
  }
}

ResponseExample response
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 10,
      "is_last_page": false
    },
    "data": [
      {
        "block_timestamp": "2026-05-21T23:00:00",
        "token_address": "0x3da932456d082cba208feb0b096d49b202bf89c8",
        "chain": "ethereum",
        "token_amount": 71640.76153419405,
        "value_usd": 1210.433326836379,
        "token_symbol": "DEGOV2"
      },
      {
        "block_timestamp": "2026-05-21T23:00:00",
        "token_address": "0x83f4389ccce1cc044dd7441add33c4f28b967434",
        "chain": "ethereum",
        "token_amount": 19667731.360383447,
        "value_usd": 95621.86555226526,
        "token_symbol": "DRX"
      },
      {
        "block_timestamp": "2026-05-21T23:00:00",
        "token_address": "0x44e18207b6e98f4a786957954e462ed46b8c95be",
        "chain": "ethereum",
        "token_amount": 42069,
        "value_usd": 0.02493684883516012,
        "token_symbol": "TERMINUS"
      }
    ]
  },
  "h402": {
    "routeId": "crypto/wallet-balance-history",
    "provider": "nansen",
    "selectedCandidateId": "crypto/wallet-balance-history/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
3.20s
Calls
6
100%
$0.01$0.010/call
allium
x402mpp
100
Success
100%
p50
2.46s
Calls
5
100%
$0.01$0.010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider