# Nansen Smart Money Historical Holdings

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

Retrieves historical token holdings data for smart money wallets tracked by Nansen

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/smart-money/historical-holdings
- Price: $0.01/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-64f4d732
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8ZKFnkdc5zPiubX5siLNi

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 api-nansen-ai-64f4d732
```

Example prompt: Pull Nansen's smart money historical holdings for the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 over the past 90 days so I can see which tokens those smart money wallets were holding before the recent market move.

## When to prefer this

Use this endpoint when you need to analyze what tokens smart money wallets held at specific points in the past, particularly to identify patterns before major price movements or to audit the historical composition of labeled whale/smart money portfolios. Prefer this over current-holdings endpoints when temporal context or trend analysis is required.

## Known failure modes

- Invalid or unrecognized wallet address returns an error or empty result
- Entity name not found in Nansen's label database
- Time range out of bounds or too large returns a 400 or truncated response
- Missing required body parameters causes a 422 validation error
- Rate limiting or insufficient credits returns a 402 or 429 error
- Unsupported blockchain or token address format causes a lookup failure

## How this service works

Get Smart Money Historical Holdings Data

## Output

Returns a historical record of token holdings for the specified smart money wallet(s) or entity, including token identifiers, quantities held, timestamps, and portfolio composition snapshots over the requested time period.

## Example request

```json
{
 "chains": [
  "ethereum"
 ],
 "order_by": [
  {
   "field": "value_usd",
   "direction": "DESC"
  }
 ],
 "date_range": {
  "to": "2024-01-31",
  "from": "2024-01-01"
 },
 "pagination": {
  "page": 1,
  "per_page": 10
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SmartMoneyHistoricalHoldingsRequest",
 "required": [
  "date_range",
  "chains"
 ],
 "properties": {
  "chains": {
   "type": "array",
   "items": {
    "enum": [
     "base",
     "bnb",
     "ethereum",
     "monad",
     "solana"
    ],
    "type": "string",
    "title": "SmartMoneyHistoricalHoldingsChain",
    "description": "Chains supported for smart money historical holdings endpoint."
   },
   "title": "Chains",
   "examples": [
    [
     "ethereum"
    ],
    [
     "base"
    ],
    [
     "bnb"
    ],
    [
     "monad"
    ],
    [
     "solana"
    ]
   ],
   "description": "Chains to include in the analysis. Supports ethereum, base, bnb, monad, 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
           ],
           "description": "Maximum value (inclusive)"
          },
          "min": {
           "anyOf": [
            {
… (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": [
       "base",
       "bnb",
       "ethereum",
       "monad",
       "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 holdings for this token"
     },
     "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-nansen-ai-64f4d732/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)