{"uid":"cap_FWGLzq7y5x_BBx9G5xqC7","slug":"api-nansen-ai-27412274","name":"Nansen Smart Money Netflow","description":"Get Smart Money Netflow Data","url":"https://api.nansen.ai/api/v1/smart-money/netflow","method":"GET","headers":{},"bodySchema":{"type":"object","title":"SmartMoneyNetflowRequest","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":"SmartMoneyNetflowFilters","properties":{"token_sector":{"anyOf":[{"type":"array","items":{"type":"string"}}],"title":"Token Sector","examples":[["DeFi","NFT","Gaming"]],"description":"Token sector filter"},"trader_count":{"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":100,"min":1}],"description":"Trader count range filter"},"token_address":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Token Address","examples":["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"description":"Token address or symbol 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":1000000000,"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"},"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 netflow endpoint.\n\nThese filters control which smart money categories, tokens, and data\nare included in the netflow analysis.","additionalProperties":false}],"examples":[{"include_stablecoins":false,"include_native_tokens":false,"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[SmartMoneyNetflowSortField]","required":["field","direction"],"properties":{"field":{"enum":["chain","token_address","token_symbol","net_flow_1h_usd","net_flow_24h_usd","net_flow_7d_usd","net_flow_30d_usd","token_sectors","trader_count","token_age_days","market_cap_usd"],"type":"string","title":"SmartMoneyNetflowSortField","description":"Enum for sortable fields in smart money netflow."},"direction":{"enum":["ASC","DESC"],"type":"string","title":"SortDirection","description":"Enum for sort directions."}}}}],"title":"Order By","examples":[[{"field":"net_flow_24h_usd","direction":"DESC"}]],"description":"Custom sort order to override the endpoint's default ordering.\n\nExamples:\n- [{\"field\": \"market_cap_usd\", \"direction\": \"DESC\"}] - Sort by market cap descending\n- [{\"field\": \"net_flow_24h_usd\", \"direction\": \"ASC\"}] - Sort by 24h flow ascending\n- [{\"field\": \"market_cap_usd\", \"direction\": \"DESC\"}, {\"field\": \"net_flow_24h_usd\", \"direction\": \"ASC\"}] - Sort by market cap descending, then 24h flow 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":"SmartMoneyNetflowResponse","required":["data","pagination"],"properties":{"data":{"type":"array","items":{"type":"object","title":"SmartMoneyNetflow","required":["token_address","token_symbol","net_flow_1h_usd","net_flow_24h_usd","net_flow_7d_usd","net_flow_30d_usd","chain","token_sectors","trader_count","token_age_days"],"properties":{"chain":{"type":"string","title":"Chain","description":"Blockchain chain"},"token_symbol":{"type":"string","title":"Token Symbol","description":"Token symbol"},"trader_count":{"type":"integer","title":"Trader Count","description":"Number of Smart Money traders of token in the past 30 days."},"token_address":{"type":"string","title":"Token Address","description":"Token contract address"},"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."},"net_flow_1h_usd":{"type":"number","title":"Net Flow 1H Usd","description":"Net flow bought/sold of token by Smart Money in the past 1 hour."},"net_flow_7d_usd":{"type":"number","title":"Net Flow 7D Usd","description":"Net flow bought/sold of token by Smart Money in the past 7 days."},"net_flow_24h_usd":{"type":"number","title":"Net Flow 24H Usd","description":"Net flow bought/sold of token by Smart Money in the past 24 hours."},"net_flow_30d_usd":{"type":"number","title":"Net Flow 30D Usd","description":"Net flow bought/sold of token by Smart Money in the past 30 days."}},"description":"Individual smart money netflow record.\n\nRepresents a single token's smart money netflow data."},"title":"Data","description":"List of smart money netflow 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 netflow endpoint.\n\nContains the filtered smart money netflow data with metadata."},"example":{"request":{"chains":["ethereum"],"order_by":[{"field":"net_flow_24h_usd","direction":"DESC"}],"pagination":{"page":1,"per_page":10}},"response":{"data":[{"chain":"ethereum","token_symbol":"UPEG","trader_count":42,"token_address":"0x44b28991b167582f18ba0259e0173176ca125505","token_sectors":[],"market_cap_usd":14731455,"token_age_days":44,"net_flow_1h_usd":-2924.587316193401,"net_flow_7d_usd":13115.387162623196,"net_flow_24h_usd":4849.23987916801,"net_flow_30d_usd":-161434.06061230713},{"chain":"ethereum","token_symbol":"FT","trader_count":2,"token_address":"0x5dd1a7a369e8273371d2dbf9d83356057088082c","token_sectors":["Memecoins"],"market_cap_usd":128961130,"token_age_days":193,"net_flow_1h_usd":0,"net_flow_7d_usd":4493.54530540953,"net_flow_24h_usd":4493.54530540953,"net_flow_30d_usd":4493.54530540953},{"chain":"ethereum","token_symbol":"ELIEN","trader_count":3,"token_address":"0xc7e4254a72169fdf7a2e080462724f2f642daf7e","token_sectors":["Memecoins"],"market_cap_usd":1387418.6928461,"token_age_days":37,"net_flow_1h_usd":0,"net_flow_7d_usd":-164.5578322585361,"net_flow_24h_usd":2190.169807584689,"net_flow_30d_usd":-19502.71707203677},{"chain":"ethereum","token_symbol":"🌱 NPCAI","trader_count":1,"token_address":"0xcb7a26d457b51b7794dfeca018751edd22491d7b","token_sectors":[],"market_cap_usd":210291.679519517,"token_age_days":1,"net_flow_1h_usd":0,"net_flow_7d_usd":2038.3793014840912,"net_flow_24h_usd":2038.3793014840912,"net_flow_30d_usd":2038.3793014840912},{"chain":"ethereum","token_symbol":"SPCX","trader_count":12,"token_address":"0xa17f383786cf2241affe41b130d8c373fdb34574","token_sectors":["Memecoins"],"market_cap_usd":607016,"token_age_days":567,"net_flow_1h_usd":0,"net_flow_7d_usd":15117.434728649805,"net_flow_24h_usd":1999.2107292220717,"net_flow_30d_usd":10591.57522780456},{"chain":"ethereum","token_symbol":"🌱 CALI","trader_count":3,"token_address":"0xc05e0e564c9292abdb52f843acedb093b78b0f45","token_sectors":[],"market_cap_usd":356215.311553104,"token_age_days":1,"net_flow_1h_usd":0,"net_flow_7d_usd":1481.7617180894565,"net_flow_24h_usd":1426.8655110388638,"net_flow_30d_usd":1481.7617180894565},{"chain":"ethereum","token_symbol":"LODE","trader_count":1,"token_address":"0xadaf95906c05c5c5de12db00a38e0b02d7ffd5e9","token_sectors":[],"market_cap_usd":1381048.82348362,"token_age_days":18,"net_flow_1h_usd":0,"net_flow_7d_usd":866.8647361846515,"net_flow_24h_usd":866.8647361846515,"net_flow_30d_usd":866.8647361846515},{"chain":"ethereum","token_symbol":"ALIENS","trader_count":7,"token_address":"0xc77867d630dbe567d219a86fddbe7ef1f0670fdc","token_sectors":["Memecoins"],"market_cap_usd":338212,"token_age_days":894,"net_flow_1h_usd":0,"net_flow_7d_usd":-1832.0572760812192,"net_flow_24h_usd":734.7746223409572,"net_flow_30d_usd":-32530.43347187752},{"chain":"ethereum","token_symbol":"🌱 CIL","trader_count":1,"token_address":"0xe5635b29e84b0a0170038b24dbae22cb641e30c2","token_sectors":[],"market_cap_usd":35577.4359631363,"token_age_days":1,"net_flow_1h_usd":0,"net_flow_7d_usd":324.43765092079286,"net_flow_24h_usd":324.43765092079286,"net_flow_30d_usd":324.43765092079286},{"chain":"ethereum","token_symbol":"OBOL","trader_count":1,"token_address":"0x0b010000b7624eb9b3dfbc279673c76e9d29d5f7","token_sectors":[],"market_cap_usd":1418810,"token_age_days":1348,"net_flow_1h_usd":0,"net_flow_7d_usd":99.8355848505876,"net_flow_24h_usd":99.8355848505876,"net_flow_30d_usd":99.8355848505876}],"pagination":{"page":1,"per_page":10,"is_last_page":false}}},"exampleRequest":{"chains":["ethereum"],"order_by":[{"field":"net_flow_24h_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_Y9c1uEwmRPdTNblKk6855","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_nUZDOr1Z9Ew_nr9Ugavoc","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":"Retrieves net capital flow data from smart money wallets tracked by Nansen for a given token or address","exampleAgentPrompt":"Pull the Nansen smart money netflow data for WBTC on Ethereum over the past 7 days — I want to see whether labeled smart money wallets are net buyers or sellers right now.","exampleUseCases":null,"resultDescription":"Returns net capital flow figures (inflows minus outflows) from Nansen-labeled smart money wallets for the requested token or address, including granular inflow and outflow breakdowns and associated wallet labels over the specified time window.","failureModes":["Invalid or unsupported token address returns 400 error","Unsupported blockchain network returns 422 validation error","Payment not attached or insufficient USDC balance returns 402 payment required","Rate limit exceeded returns 429 too many requests","No smart money activity found for requested period returns empty dataset"],"whenToPreferThis":"Use this endpoint when you need authoritative on-chain smart money flow intelligence specifically from Nansen's curated wallet label database. Prefer this over generic on-chain tools when the user wants to know whether high-signal wallets (VCs, funds, top traders) are net accumulating or distributing a token, as Nansen's proprietary labeling system makes this uniquely actionable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:50:55.539Z","isFirstParty":false}