# Nansen Smart Money Holdings > Nansen Smart Money Holdings is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.05/call, status unknown (last checked 2026-10-10). Retrieve aggregated token balances held by smart traders and funds across multiple blockchains, filtered to exclude whales and influencers. ## Facts - Endpoint: POST https://api.nansen.ai/api/v1/smart-money/holdings?utm_source=zero.xyz - Price: $0.05/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-holdings-70e83659 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O_HxFCpb4QV0KNrVP70kJ 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-holdings-70e83659 -d '' ``` Example prompt: Show me what tokens smart money traders are accumulating right now on Ethereum and Solana — filter to tokens with at least 20 holders and a minimum $5,000 USD value held, and include the 24-hour balance change so I can see what's being actively bought. ## When to prefer this Use this endpoint when you need to identify which tokens sophisticated traders and funds are accumulating across blockchains, specifically excluding noise from whale wallets and influencers. Prefer this over general token screeners when the signal you want is professional trading expertise rather than raw volume or price momentum. Best for generating token watchlists, identifying early accumulation, or sector-level analysis of smart money positioning. ## Known failure modes - Missing required 'chains' field returns 422 validation error - Invalid chain name in chains array returns 422 with enum validation error - Invalid filter range (min > max) returns 422 validation error - Unauthenticated or unpaid requests return 402 Payment Required - Rate limiting or quota exhaustion returns 429 Too Many Requests - Requesting 'monad' or other pre-launch chains may return empty data sets ## How this service works Retrieve aggregated token balances held by smart traders across multiple blockchains. This endpoint provides insights into what tokens are being accumulated by sophisticated market participants, excluding whales, large holders, and influencers to focus specifically on trading expertise. Key Features: - Aggregated balances (not per-wallet breakdowns) - 24-hour balance change tracking updated in realtime - Sector categorization for tokens ## Output A paginated list of token holding records showing for each token: chain, token address and symbol, number of smart money holders, total USD value held, 24h balance percent change, token sector categories, market cap, token age in days, and share of total smart money holdings. Each record represents aggregated positions across all tracked smart traders and funds, not individual wallet breakdowns. ## Request schema (JSON Schema) ```json { "type": "object", "title": "SmartMoneyHoldingsRequest", "required": [ "chains" ], "properties": { "chains": { "type": "array", "items": { "enum": [ "all", "arbitrum", "arc", "avalanche", "base", "bnb", "ethereum", "hyperevm", "iotaevm", "linea", "mantle", "monad", "optimism", "plasma", "polygon", "robinhood", "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", "arc", "avalanche", "base", "bnb", "ethereum", "hyperevm", "iotaevm", "linea", "mantle", "monad", "optimism", "plasma", "polygon", "robinhood", "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": "Fraction of total Smart Money USD holdings across all chains and all Smart Money wallets. A value of 0.05 means 5%. Chain, label, and token filters, stablecoin/native inclusion flags, and pagination do not narrow the denominator, so returned shares need not sum to 1 (100%)." }, "balance_24h_percent_change": { "anyOf": [ { … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-holdings-70e83659/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)