Skip to content
onelayer.
All tools

Tool detail

Nansen

Returns historical token balances for a blockchain address over time, filterable by chain and date.

Categories: Onchain data

Use when

  • get historical token balances for a wallet address
  • track how a wallet's holdings changed over time on one chain
  • audit an address's balances as of past dates

Not for

  • not current/live balance only — built for historical series
  • not transaction-level activity

Inputs

POST JSON body (required): chain (string), date (object); optional: address (string), entity_name (string), filters (object), order_by (array), pagination (object).

Inputs undocumented: open object without declared properties

Endpoint

Method
POST
URL
https://api.nansen.ai/api/v1/profiler/address/historical-balances

Payment

Protocol
x402
Listed price
$0.01 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://api.nansen.ai/api/v1/profiler/address/historical-balances
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z