Historical Address Balance

Get Historical Balances by Address (Beta)

post

Beta — subject to breaking changes.

Token balances for a wallet address as of a historical snapshot date.

Supports EVM chains (ethereum, base, bnb) and solana. Balances are computed from on-chain transfer history up to as_of_date. Results are ordered by USD value descending.

Authorizations

apikeystringRequired

API key for authentication

Body

Request model for the profiler historical token balances endpoint.

Returns token balances for an address as of a historical snapshot date. Supports EVM chains (ethereum, base, bnb) and solana.

addressstringRequired

Wallet address (EVM hex or Solana base58)

Example: 0xd8da6bf26964af9d7eed9e03e53415d37aa96045

as_of_datestring · dateRequired

Historical snapshot date — balances are computed up to this date

Example: 2025-06-15

chainstring · enumRequired

Chain filter

Example: ethereumPossible values:

apply_blacklist_filterbooleanOptional

When True, exclude blacklisted addresses from the results. Defaults to True.

Default: trueExample: true

Responses

200

Historical token balance records

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1beta1/profiler/address/historical-token-balances

POST /api/v1beta1/profiler/address/historical-token-balances HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 169

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "as_of_date": "2025-06-15",
  "chain": "ethereum",
  "apply_blacklist_filter": true,
  "pagination": {
    "page": 1,
    "per_page": 10
  }
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "chain": "ethereum",
      "token_address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
      "token_symbol": "AAVE",
      "name": "Aave",
      "token_amount": 100.5,
      "price_usd": 85.5,
      "value_usd": 8592.75
    }
  ]
}