{"uid":"cap_O_HxFCpb4QV0KNrVP70kJ","slug":"nansen-holdings-70e83659","name":"Nansen Smart Money Holdings","description":"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.\n\nKey Features:\n\n- Aggregated balances (not per-wallet breakdowns)\n- 24-hour balance change tracking updated in realtime\n- Sector categorization for tokens","url":"https://api.nansen.ai/api/v1/smart-money/holdings?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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":[{"type":"object","title":"IntegerRangeFilter","properties":{"max":{"anyOf":[{"type":"integer"}],"title":"Max","examples":[100,1000,10000],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"integer"}],"title":"Min","examples":[10,100,1000],"description":"Minimum value (inclusive)"}},"description":"Filter for integer values with optional min/max bounds.\nUse for counts, numbers of items, and other whole number values. - Values between 5 and 100"}],"examples":[{"max":1000,"min":10}],"description":"Number of holders range filter"},"token_address":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Token Address","examples":["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"description":"Token address filter"},"token_sectors":{"anyOf":[{"type":"array","items":{"type":"string"}}],"title":"Token Sectors","examples":[["DeFi","Gaming"]],"description":"Token sectors filter"},"market_cap_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":10000000,"min":1000000}],"description":"Market cap range filter in USD"},"token_age_days":{"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":365,"min":1}],"description":"Token age range filter in days"},"include_stablecoins":{"anyOf":[{"type":"boolean"}],"title":"Include Stablecoins","default":false,"description":"Whether to include stablecoins in the results"},"include_native_tokens":{"anyOf":[{"type":"boolean"}],"title":"Include Native Tokens","default":false,"description":"Whether to include native tokens (e.g., ETH, SOL) in the results"},"share_of_holdings_percent":{"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":0.1,"min":0.01}],"description":"Range filter for the fraction of total Smart Money USD holdings across all chains. A value of 0.05 means 5%; chain, label, and token filters do not narrow the denominator."},"balance_24h_percent_change":{"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":0.5,"min":-0.5}],"description":"24-hour balance change percentage range filter"},"exclude_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["Fund","Smart Trader","30D Smart Trader","90D Smart Trader","180D Smart Trader","Smart HL Perps Trader"],"type":"string","title":"SmartMoneyFilterType","description":"Filter by smart money label type."}}],"title":"Exclude Smart Money Labels","examples":[["30D Smart Trader"]],"description":"Smart money category filters. `Fund` is deprecated for this endpoint. Excluding `Fund` has no effect because Fund wallets are no longer part of the current Smart Money cohort."},"include_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["Fund","Smart Trader","30D Smart Trader","90D Smart Trader","180D Smart Trader","Smart HL Perps Trader"],"type":"string","title":"SmartMoneyFilterType","description":"Filter by smart money label type."}}],"title":"Include Smart Money Labels","examples":[["Smart Trader","30D Smart Trader"]],"description":"Smart money category filters. `Fund` is deprecated for this endpoint. Including `Fund` returns no rows because Fund wallets are no longer part of the current Smart Money cohort; use /api/v1beta1/funds/holdings for current Fund holdings."}},"description":"Filters for smart money holdings endpoint.\n\nThese filters control which token holdings, smart money categories,\nand data are included in the holdings analysis.","additionalProperties":false}],"examples":[{"value_usd":{"max":100000,"min":1000},"token_age_days":{"max":30},"include_stablecoins":false,"include_native_tokens":false,"balance_24h_percent_change":{"max":0.1,"min":-0.1},"exclude_smart_money_labels":["30D Smart Trader"],"include_smart_money_labels":["Smart Trader"]}],"description":"Additional filters to apply. Only filters for columns that are being selected will be applied."},"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"SmartMoneyHoldingsSortOrder","required":["field","direction"],"properties":{"field":{"enum":["chain","token_address","token_symbol","value_usd","balance_24h_percent_change","holders_count","share_of_holdings_percent","token_age_days","market_cap_usd"],"type":"string","title":"SmartMoneyHoldingsSortField","description":"Enum for sortable fields in smart money holdings."},"direction":{"enum":["ASC","DESC"],"type":"string","title":"SortDirection","description":"Enum for sort directions."}}}}],"title":"Order By","description":"Custom sort order to override the endpoint's default ordering.\n\nExamples:\n- [{\"field\": \"value_usd\", \"direction\": \"DESC\"}] - Sort by value USD descending\n- [{\"field\": \"holders_count\", \"direction\": \"ASC\"}] - Sort by number of holders ascending\n- [{\"field\": \"value_usd\", \"direction\": \"DESC\"}, {\"field\": \"holders_count\", \"direction\": \"ASC\"}] - Sort by value USD descending, then number of holders ascending"},"pagination":{"type":"object","title":"PaginationRequest","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Page number (1-based)"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page (max 1000)"}},"description":"Pagination parameters for API requests."}},"description":"","additionalProperties":false},"responseSchema":{"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":[{"type":"number"}],"title":"Balance 24H Percent Change","description":"Balance change of Smart Money for token during the last 24 hours"}},"description":"Individual smart money holding record.\n\nRepresents a single token's smart money holding data."},"title":"Data","description":"List of smart money holding records"},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response model for smart money holdings endpoint.\n\nContains the filtered smart money holdings data with metadata."},"example":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HMMke9KE8rbMLPdRzN9rq","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Retrieve aggregated token balances held by smart traders and funds across multiple blockchains, filtered to exclude whales and influencers.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:39:45.701Z","isFirstParty":false,"canonicalSlug":"api-nansen-ai-2bf04b4e"}