Historical Smart Money Positions

Note: This is a beta endpoint (/api/v1beta1/). Request shapes, response fields, and pricing may change as we iterate.

Data Freshness & Snapshot Timing

This endpoint returns point-in-time daily snapshots keyed by as_of_date. Each snapshot represents end-of-day UTC values for that date.

• Daily snapshots only — the current day is excluded. Querying as_of_date = today (or any date whose snapshot has not yet been produced) returns an empty data array with HTTP 200 — never a live or partial current-day result.

• Settlement timing. A given day's snapshot is produced by a daily batch the following morning (UTC); exact timing varies. Until that batch completes, the prior day returns empty, so in the early-UTC hours the freshest available snapshot may be two days back. Rather than assuming a fixed availability time, query the date you need and fall back to the previous day (or retry later) if it comes back empty.

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

apikeystringRequired

API key for authentication

Body

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

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1beta1/smart-money/historical-token-balances

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