Historical Smart Money Positions

Get Historical SM Token Balances (Beta)

post

Beta — subject to breaking changes.

Point-in-time smart money token balance aggregates for a given date.

Returns SM token holdings per (chain, token_address) pair filtered by SM labels, token type, and chain. Includes 24h balance change, holder counts, share of total SM holdings, and historical market cap.

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for the historical SM token balances endpoint.

Returns smart money token balance aggregates for a given date, filtered by chain, SM label, and token type.

as_of_datestring · dateRequired

Date to query balances for

Example: 2025-01-15

filtersany ofOptional

Optional filters for SM labels and token types

apply_blacklist_filterbooleanOptional

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

Default: trueExample: true

Responses

200

Historical SM token balances data

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/smart-money/historical-token-balances

HTTPcURLJavaScriptPython

POST /api/v1beta1/smart-money/historical-token-balances HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 265

{
  "as_of_date": "2025-01-15",
  "chains": [
    "ethereum",
    "base"
  ],
  "filters": {
    "sm_filter": [
      "Fund",
      "Smart Trader"
    ],
    "include_stablecoins": true,
    "include_native_tokens": true,
    "holders_count": {
      "max": 1000,
      "min": 2
    }
  },
  "apply_blacklist_filter": true,
  "pagination": {
    "page": 1,
    "per_page": 10
  }
}

{
  "data": [
    {
      "chain": "ethereum",
      "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "token_symbol": "PEPE",
      "token_sectors": [
        "DeFi",
        "DEX"
      ],
      "value_usd": 1500000,
      "balance_24h_percent_change": 0.05,
      "holders_count": 42,
      "share_of_holdings_percent": 0.003,
      "token_age_days": 365,
      "market_cap_usd": 50000000
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  }
}