# Nansen Smart Money Holdings

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

Returns aggregated token holdings data for 'smart money' wallets across specified blockchain networks, including USD value, holder counts, and portfolio share

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/smart-money/holdings?utm_source=zero.xyz
- Price: $0.05/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-2bf04b4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7KEuIv3w06kGOnya1M9er

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-2bf04b4e
```

Example prompt: Show me the top 10 tokens by USD value held by Nansen smart money wallets on Ethereum right now, including sector labels and 24-hour balance changes.

## When to prefer this

Use this endpoint when you need to understand what tokens sophisticated or high-signal crypto wallets (Nansen's 'smart money') are holding, ranked by portfolio value or other metrics. Ideal for market intelligence, trend spotting, and identifying which tokens institutional or whale-tier addresses are accumulating. Prefer this over generic on-chain queries when you want Nansen's curated smart money wallet labels applied to holdings aggregation.

## Known failure modes

- Invalid or unsupported chain specified — returns error indicating chain not supported by smart money data
- Malformed filter parameters for non-selected columns — API rejects with filter validation error
- Pagination offset exceeding available results — returns empty data array
- Missing or invalid authentication — returns 401/403 unauthorized
- Rate limiting exceeded — returns 429 too many requests
- Network timeout for large multi-chain queries — partial or no data returned

## How this service works

Get Smart Money Holdings Data

## Output

An array of token holding records for smart money wallets, each containing: chain, token symbol, token address, total USD value held, number of smart money holders, market cap in USD, token age in days, sector classifications, share of total smart money holdings as a percentage, and 24-hour balance percent change.

## Example request

```json
{
 "chains": [
  "ethereum"
 ],
 "filters": {
  "include_stablecoins": false,
  "include_native_tokens": false,
  "include_smart_money_labels": [
   "Fund",
   "Smart Trader"
  ]
 },
 "order_by": [
  {
   "field": "value_usd",
   "direction": "DESC"
  }
 ],
 "pagination": {
  "page": 1,
  "per_page": 10
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SmartMoneyHoldingsRequest",
 "required": [
  "chains"
 ],
 "properties": {
  "chains": {
   "type": "array",
   "items": {
    "enum": [
     "all",
     "arbitrum",
     "avalanche",
     "base",
     "bnb",
     "ethereum",
     "hyperevm",
     "iotaevm",
     "linea",
     "mantle",
     "monad",
     "optimism",
     "plasma",
     "polygon",
     "ronin",
     "scroll",
     "sei",
     "solana",
     "sonic"
    ],
    "type": "string",
    "title": "SmartMoneyChain",
    "description": "Chains supported in smart money analysis."
   },
   "title": "Chains",
   "examples": [
    [
     "ethereum",
     "solana"
    ]
   ],
   "description": "Chains to include in the analysis (only smart money supported chains). Use 'all' to include all available chains."
  },
  "filters": {
   "anyOf": [
    {
     "type": "object",
     "title": "SmartMoneyHoldingsFilters",
     "properties": {
      "value_usd": {
       "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": 100000,
         "min": 1000
        }
       ],
       "description": "Value range filter in USD"
      },
      "token_symbol": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "array",
         "items": {
          "type": "string"
         }
        },
        {
         "type": "null"
        }
       ],
       "title": "Token Symbol",
       "examples": [
        "USDC"
       ],
       "description": "Token symbol filter"
      },
      "holders_count": {
       "anyOf": [
        {
       
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SmartMoneyHoldingsResponse",
 "required": [
  "data",
  "pagination"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "SmartMoneyHolding",
    "required": [
     "chain",
     "token_address",
     "token_symbol",
     "token_sectors",
     "holders_count",
     "token_age_days"
    ],
    "properties": {
     "chain": {
      "enum": [
       "all",
       "arbitrum",
       "avalanche",
       "base",
       "bnb",
       "ethereum",
       "hyperevm",
       "iotaevm",
       "linea",
       "mantle",
       "monad",
       "optimism",
       "plasma",
       "polygon",
       "ronin",
       "scroll",
       "sei",
       "solana",
       "sonic"
      ],
      "type": "string",
      "title": "SmartMoneyChain",
      "description": "Chains supported in smart money analysis."
     },
     "value_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Value Usd",
      "description": "Value of token held by Smart Money."
     },
     "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."
     },
     "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."
     },
     "token_age_days": {
      "type": "integer",
      "title": "Token Age Days",
      "description": "Number of days since token was deployed."
     },
     "share_of_holdings_percent": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Share Of Holdings Percent",
      "description": "Share of Smart Money total USD balance."
     },
     "balance_24h_percent_change": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Balance 24H Percent Change",
      "description": "Balance change of Smart Money for token during the last 24 hours"
     }
    },
    "description": "Individual smart money holdin
… (truncated)
```

## More

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