# Nansen Smart Money Historical Holdings

> Nansen Smart Money Historical Holdings is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.01/call, status unknown (last checked 2026-10-10).

Retrieve time-series daily snapshots of aggregated token balances held by smart traders and funds across multiple blockchains.

## Facts

- Endpoint: POST https://api.nansen.ai/api/v1/smart-money/historical-holdings?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: Nansen
- Docs: https://docs.nansen.ai
- Website: https://nansen.ai
- Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data
- Canonical page: https://www.zero.xyz/c/nansen-historical-holdings-4b1f8b7c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I8r0nouQtQO2Q0efRwZEJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nansen-historical-holdings-4b1f8b7c -d '<json body>'
```

Example prompt: Pull Nansen's historical smart money holdings snapshots for Ethereum and Solana from January 1 2024 to December 31 2024, filtered to tokens with at least $10,000 USD value held, so I can see how smart traders rotated between assets over the year.

## When to prefer this

Use this endpoint when you need historical time-series data on smart money token holdings — for backtesting trading strategies, analyzing trend rotations, or performing performance attribution. Prefer this over current holdings when temporal context and snapshot history are needed rather than a single point-in-time view.

## Known failure modes

- Invalid or unsupported chain returns validation error
- Date range exceeding 4-year lookback returns 400 error
- Missing required fields (chains or date_range) returns 422 validation error
- No data found for the specified filters returns empty data array
- Authentication failure or missing API key returns 401 unauthorized
- Rate limit exceeded returns 429 too many requests

## How this service works

Retrieve historical snapshots of aggregated token balances held by smart traders and funds. This endpoint provides time-series data for trend analysis, backtesting, and performance attribution.

Key Features:

- Daily snapshots of smart money holdings
- Date range filtering (max 4 years lookback)
- Point-in-time pricing and market cap data
- Balance change tracking between snapshots
- Same filtering options as current holdings endpoint

Use Cases:

- Trend Analysis: Track how smart money rotates between assets over time
- Performance Attribution: Combine with price data to estimate ROI
- Backtesting: Validate trading strategies based on historical smart money behavior

## Output

An array of daily snapshot records, each containing the date, chain, token address, token symbol, token sectors, smart money labels present, number of smart money holders, token balance, USD value held, market cap at snapshot date, token age in days, share of smart money total holdings, and balance percent changes between snapshots — plus pagination metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SmartMoneyHistoricalHoldingsRequest",
 "required": [
  "date_range",
  "chains"
 ],
 "properties": {
  "chains": {
   "type": "array",
   "items": {
    "enum": [
     "arc",
     "base",
     "bnb",
     "ethereum",
     "monad",
     "robinhood",
     "solana"
    ],
    "type": "string",
    "title": "SmartMoneyHistoricalHoldingsChain",
    "description": "Chains supported for smart money historical holdings endpoint."
   },
   "title": "Chains",
   "examples": [
    [
     "ethereum"
    ],
    [
     "base"
    ],
    [
     "bnb"
    ],
    [
     "monad"
    ],
    [
     "robinhood"
    ],
    [
     "arc"
    ],
    [
     "solana"
    ]
   ],
   "description": "Chains to include in the analysis. Supports ethereum, base, bnb, monad, robinhood, arc, and solana."
  },
  "filters": {
   "anyOf": [
    {
     "type": "object",
     "title": "SmartMoneyHistoricalHoldingsFilters",
     "properties": {
      "balance": {
       "anyOf": [
        {
         "type": "object",
         "title": "NumericRangeFilter",
         "properties": {
          "max": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Max",
           "examples": [
            50000,
            10000000,
            100
           ],
           "description": "Maximum value (inclusive)"
          },
          "min": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Min",
           "examples": [
            1000,
            1000000,
            -50,
            0
           ],
           "description": "Minimum value (inclusive)"
          }
         },
         "description": "Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"
        }
       ],
       "examples": [
        {
         "max": 10000,
         "min": 100
        }
       ],
       "description": "Token balance range filter in human-readable units"
      },
      "value_usd": {
       "anyOf": [
        {
         "type": "object",
         "title": "NumericRangeFilter",
         "properties": {
          "max": {
           "anyOf": [
            {
             "type": "number"
            }
           ],
           "title": "Max",
           "examples": [
            50000,
            10000000,
            100
           ],
           "descripti
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SmartMoneyHistoricalHoldingsResponse",
 "required": [
  "data",
  "pagination"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "SmartMoneyHistoricalHolding",
    "required": [
     "date",
     "chain",
     "token_address",
     "token_symbol",
     "token_sectors",
     "smart_money_labels",
     "holders_count",
     "token_age_days"
    ],
    "properties": {
     "date": {
      "type": "string",
      "title": "Date",
      "description": "Snapshot date (YYYY-MM-DD)"
     },
     "chain": {
      "enum": [
       "arc",
       "base",
       "bnb",
       "ethereum",
       "monad",
       "robinhood",
       "solana"
      ],
      "type": "string",
      "title": "SmartMoneyHistoricalHoldingsChain",
      "description": "Chains supported for smart money historical holdings endpoint."
     },
     "balance": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Balance",
      "description": "Token balance in human-readable units (accounting for decimals)"
     },
     "value_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Value Usd",
      "description": "Value of token held by Smart Money at snapshot date"
     },
     "token_symbol": {
      "type": "string",
      "title": "Token Symbol",
      "description": "Token symbol"
     },
     "holders_count": {
      "type": "integer",
      "title": "Holders Count",
      "description": "Number of Smart Money holders of token at snapshot date"
     },
     "token_address": {
      "type": "string",
      "title": "Token Address",
      "description": "Address of token"
     },
     "token_sectors": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "Token Sectors",
      "description": "Token sectors"
     },
     "market_cap_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Market Cap Usd",
      "description": "Market cap of token at snapshot date"
     },
     "token_age_days": {
      "type": "integer",
      "title": "Token Age Days",
      "description": "Number of days since token was deployed, relative to snapshot date"
     },
     "smart_money_labels": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "title": "Smart Money Labels",
      "description": "Array of unique smart money labels present in the aggregated holdi
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-historical-holdings-4b1f8b7c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)