{"uid":"cap_7KEuIv3w06kGOnya1M9er","slug":"api-nansen-ai-2bf04b4e","name":"Nansen Smart Money Holdings","description":"Get Smart Money Holdings Data","url":"https://api.nansen.ai/api/v1/smart-money/holdings?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":[{"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":"Share of holdings percentage range filter"},"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"},"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":[["Fund","Smart Trader"]],"description":"Smart money category filters"}},"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":["Fund","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":"SortOrder[SmartMoneyHoldingsSortField]","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","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 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":{"request":{"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}},"response":{"data":[{"chain":"ethereum","value_usd":124199727.31268592,"token_symbol":"UNI","holders_count":27,"token_address":"0x1f9840a85d5af5bf1d1762f925bdaddc4201f984","token_sectors":["Decentralised Exchanges"],"market_cap_usd":1933238437,"token_age_days":2083,"share_of_holdings_percent":6.50560934571805e-12,"balance_24h_percent_change":0},{"chain":"ethereum","value_usd":112571207.65179428,"token_symbol":"BGB","holders_count":5,"token_address":"0x54d2252757e1672eead234d27b1270728ff90581","token_sectors":[],"market_cap_usd":1389728530,"token_age_days":703,"share_of_holdings_percent":5.896504899036743e-12,"balance_24h_percent_change":0},{"chain":"ethereum","value_usd":110698664.22773816,"token_symbol":"ONDO","holders_count":17,"token_address":"0xfaba6f8e4a5e8ab82f62fe7c39859fa577269be3","token_sectors":["RWAs"],"market_cap_usd":1787908153,"token_age_days":1492,"share_of_holdings_percent":5.79842065792458e-12,"balance_24h_percent_change":0},{"chain":"ethereum","value_usd":80984108.18589887,"token_symbol":"LIT","holders_count":4,"token_address":"0x232ce3bd40fcd6f80f3d55a522d03f25df784ee2","token_sectors":["Perps, Options and Derivatives","Scaling & Connectivity","Data source and Oracle","Decentralised Exchanges"],"market_cap_usd":336826112,"token_age_days":214,"share_of_holdings_percent":4.2419656022466325e-12,"balance_24h_percent_change":0},{"chain":"ethereum","value_usd":59477441.373725615,"token_symbol":"WLD","holders_count":21,"token_address":"0x163f8c2467924be0ae7b5347228cabf260318753","token_sectors":[],"market_cap_usd":1026210562,"token_age_days":1047,"share_of_holdings_percent":3.1154416103197397e-12,"balance_24h_percent_change":0},{"chain":"ethereum","value_usd":43698839.76393885,"token_symbol":"WLFI","holders_count":1,"token_address":"0xda5e1988097297dcdc1f90d4dfe7909e847cbef6","token_sectors":[],"market_cap_usd":1854304302,"token_age_days":607,"share_of_holdings_percent":2.2889549479411667e-12,"balance_24h_percent_change":0},{"chain":"ethereum","value_usd":24315306.8182187,"token_symbol":"USTB","holders_count":6,"token_address":"0x43415eb6ff9db7e26a15b704e7a3edce97d31c4e","token_sectors":["RWAs","Yield Bearing"],"market_cap_usd":890976004,"token_age_days":905,"share_of_holdings_percent":1.2736411802447499e-12,"balance_24h_percent_change":0},{"chain":"ethereum","value_usd":16931890.173191104,"token_symbol":"MORPHO","holders_count":4,"token_address":"0x58d97b57bb95320f9a05dc918aef65434969c2b2","token_sectors":["DeFi Lending (Money Markets)","Yield Farming Protocols"],"market_cap_usd":1308660376,"token_age_days":565,"share_of_holdings_percent":8.868961738866278e-13,"balance_24h_percent_change":0},{"chain":"ethereum","value_usd":14848766.300607303,"token_symbol":"ENA","holders_count":13,"token_address":"0x57e114b691db790c35207b2e685d4a43181e6061","token_sectors":["Stablecoin Issuers"],"market_cap_usd":797017109,"token_age_days":815,"share_of_holdings_percent":7.777816820355227e-13,"balance_24h_percent_change":0},{"chain":"ethereum","value_usd":12616116.015313366,"token_symbol":"PENDLE","holders_count":5,"token_address":"0x808507121b80c02388fad14726482e061b8da827","token_sectors":["Decentralised Exchanges","Yield Farming Protocols","Restaking"],"market_cap_usd":246922011,"token_age_days":1858,"share_of_holdings_percent":6.608349634234865e-13,"balance_24h_percent_change":-0.10125759374607421}],"pagination":{"page":1,"per_page":10,"is_last_page":false}}},"exampleRequest":{"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}},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C8Ydfd3upIm7ttFt_1B5B","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_RTaZge_kd2X4WmmNHfjK_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregated token holdings data for 'smart money' wallets across specified blockchain networks, including USD value, holder counts, and portfolio share","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:37:19.744Z","isFirstParty":false,"canonicalSlug":"api-nansen-ai-2bf04b4e"}