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

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

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

post

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

HTTPcURLJavaScriptPython

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
    }
  ]
}