{"uid":"cap_HcN2C-wUu-OcJ2SUR32on","slug":"api-nansen-ai-2fc8a903","name":"Nansen Token God Mode Flow Intelligence","description":"Get \"Token God Mode\" (TGM) flow intelligence data","url":"https://api.nansen.ai/api/v1/tgm/flow-intelligence","method":"GET","headers":{},"bodySchema":{"type":"object","title":"TGMFlowIntelligenceRequest","required":["chain","token_address"],"properties":{"chain":{"enum":["arbitrum","avalanche","base","bnb","ethereum","hyperevm","injective","iotaevm","linea","mantle","mantra","monad","near","optimism","plasma","polygon","ronin","scroll","sei","solana","sonic","starknet","sui","ton","tron"],"type":"string","title":"TGMChain","description":"Chains supported in TGM (Token God Mode) endpoints."},"filters":{"anyOf":[{"type":"object","title":"TGMFlowIntelligenceFilters","properties":{"whale_avg_flow_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":[{"min":100}],"description":"Whale average flow range filter in USD"},"whale_net_flow_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":[{"min":1000}],"description":"Whale net flow range filter in USD"},"whale_wallet_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":[{"min":1}],"description":"Whale wallet count range filter"},"top_pnl_avg_flow_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":[{"min":100}],"description":"Top PnL average flow range filter in USD"},"top_pnl_net_flow_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":[{"min":1000}],"description":"Top PnL net flow range filter in USD"},"top_pnl_wallet_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":[{"min":1}],"description":"Top PnL wallet count range filter"},"exchange_avg_flow_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":[{"min":100}],"description":"Exchange average flow range filter in USD"},"exchange_net_flow_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":[{"min":1000}],"description":"Exchange net flow range filter in USD"},"exchange_wallet_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":[{"min":1}],"description":"Exchange wallet count range filter"},"smart_trader_avg_flow_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":[{"min":100}],"description":"Smart trader average flow range filter in USD"},"smart_trader_net_flow_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":[{"min":1000}],"description":"Smart trader net flow range filter in USD"},"smart_trader_wallet_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":[{"min":1}],"description":"Smart trader wallet count range filter"},"fresh_wallets_avg_flow_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":[{"min":100}],"description":"Fresh wallets average flow range filter in USD"},"fresh_wallets_net_flow_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":[{"min":1000}],"description":"Fresh wallets net flow range filter in USD"},"fresh_wallets_wallet_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":[{"min":1}],"description":"Fresh wallets wallet count range filter"},"public_figure_avg_flow_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":[{"min":100}],"description":"Public figure average flow range filter in USD"},"public_figure_net_flow_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":[{"min":1000}],"description":"Public figure net flow range filter in USD"},"public_figure_wallet_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":[{"min":1}],"description":"Public figure wallet count range filter"}},"description":"Filters for TGM flow intelligence endpoint.\n\nThese filters control the flow intelligence analysis data.","additionalProperties":false}],"examples":[{"whale_wallet_count":{"min":1}}],"description":"Additional filters to apply to the query."},"timeframe":{"enum":["5m","1h","6h","12h","1d","7d"],"type":"string","title":"TGMFlowIntelligenceTimeframe","description":"TGM flow intelligence timeframe options."},"token_address":{"type":"string","title":"Token Address","examples":["0x6982508145454ce325ddbe47a25d4ec3d2311933"],"description":"Token address"}},"description":"Request model for TGM flow-intelligence endpoint.\n\nThis endpoint provides detailed token flow intelligence for analyzing token movements\nacross different chains. It helps track and categorize token transfers, identifying\npatterns such as exchange deposits, withdrawals, and transfers between different\ntypes of wallets.","additionalProperties":false},"responseSchema":{"type":"object","title":"TGMFlowIntelligenceResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"TGMFlowIntelligence","properties":{"whale_avg_flow_usd":{"anyOf":[{"type":"number"}],"title":"Whale Avg Flow Usd","examples":[250000.75],"description":"Geometric mean of absolute flow for Whale addresses"},"whale_net_flow_usd":{"anyOf":[{"type":"number"}],"title":"Whale Net Flow Usd","examples":[5000000.25],"description":"Net flow (USD) for addresses labeled as Whale"},"whale_wallet_count":{"anyOf":[{"type":"integer"}],"title":"Whale Wallet Count","examples":[25],"description":"Unique wallet count for Whale addresses"},"top_pnl_avg_flow_usd":{"anyOf":[{"type":"number"}],"title":"Top Pnl Avg Flow Usd","examples":[100000.5],"description":"Geometric mean of absolute flow for Top PnL addresses"},"top_pnl_net_flow_usd":{"anyOf":[{"type":"number"}],"title":"Top Pnl Net Flow Usd","examples":[2000000.75],"description":"Net flow (USD) for addresses labeled as Top PnL"},"top_pnl_wallet_count":{"anyOf":[{"type":"integer"}],"title":"Top Pnl Wallet Count","examples":[15],"description":"Unique wallet count for Top PnL addresses"},"exchange_avg_flow_usd":{"anyOf":[{"type":"number"}],"title":"Exchange Avg Flow Usd","examples":[150000.5],"description":"Geometric mean of absolute flow for Exchange addresses"},"exchange_net_flow_usd":{"anyOf":[{"type":"number"}],"title":"Exchange Net Flow Usd","examples":[3000000.75],"description":"Net flow (USD) for addresses labeled as Exchange"},"exchange_wallet_count":{"anyOf":[{"type":"integer"}],"title":"Exchange Wallet Count","examples":[5],"description":"Unique wallet count for Exchange addresses"},"smart_trader_avg_flow_usd":{"anyOf":[{"type":"number"}],"title":"Smart Trader Avg Flow Usd","examples":[75000.25],"description":"Geometric mean of absolute flow for Smart Trader addresses"},"smart_trader_net_flow_usd":{"anyOf":[{"type":"number"}],"title":"Smart Trader Net Flow Usd","examples":[1500000.5],"description":"Net flow (USD) for addresses labeled as Smart Trader"},"smart_trader_wallet_count":{"anyOf":[{"type":"integer"}],"title":"Smart Trader Wallet Count","examples":[20],"description":"Unique wallet count for Smart Trader addresses"},"fresh_wallets_avg_flow_usd":{"anyOf":[{"type":"number"}],"title":"Fresh Wallets Avg Flow Usd","examples":[25000.75],"description":"Average absolute flow (USD) for fresh wallets. Only available for 1d and 7d timeframes."},"fresh_wallets_net_flow_usd":{"anyOf":[{"type":"number"}],"title":"Fresh Wallets Net Flow Usd","examples":[500000.25],"description":"Net flow (USD) for fresh wallets. Only available for 1d and 7d timeframes."},"fresh_wallets_wallet_count":{"anyOf":[{"type":"integer"}],"title":"Fresh Wallets Wallet Count","examples":[100],"description":"Fresh wallets wallet count. Only available for 1d and 7d timeframes."},"public_figure_avg_flow_usd":{"anyOf":[{"type":"number"}],"title":"Public Figure Avg Flow Usd","examples":[50000.25],"description":"Geometric mean of absolute flow for Public Figure addresses"},"public_figure_net_flow_usd":{"anyOf":[{"type":"number"}],"title":"Public Figure Net Flow Usd","examples":[1000000.5],"description":"Net flow (USD) for addresses labeled as Public Figure"},"public_figure_wallet_count":{"anyOf":[{"type":"integer"}],"title":"Public Figure Wallet Count","examples":[10],"description":"Unique wallet count for Public Figure addresses"}},"description":"Individual TGM flow intelligence record.\n\nRepresents flow intelligence data for different wallet categories."},"title":"Data","description":"List of TGM flow intelligence records"},"warnings":{"anyOf":[{"type":"array","items":{"type":"string"}}],"title":"Warnings","description":"Optional warnings about the query results. For example, if fresh_wallets fields are null due to timeframe constraints."}},"description":"Response model for TGM flow-intelligence endpoint.\n\nContains flow intelligence data with pagination and metadata."},"example":{"request":{"chain":"ethereum","timeframe":"1h","token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"response":{"data":[{"whale_avg_flow_usd":85432.28239278116,"whale_net_flow_usd":-993785.126943404,"whale_wallet_count":5,"top_pnl_avg_flow_usd":426804.7191092955,"top_pnl_net_flow_usd":1538810.9242546503,"top_pnl_wallet_count":12,"exchange_avg_flow_usd":17548075.9263843,"exchange_net_flow_usd":-12824997.36791935,"exchange_wallet_count":0,"smart_trader_avg_flow_usd":null,"smart_trader_net_flow_usd":null,"smart_trader_wallet_count":0,"fresh_wallets_avg_flow_usd":null,"fresh_wallets_net_flow_usd":null,"fresh_wallets_wallet_count":null,"public_figure_avg_flow_usd":14154.937759310658,"public_figure_net_flow_usd":-429.8201328422392,"public_figure_wallet_count":2}],"warnings":["fresh_wallets fields are null for the requested timeframe. Please select 1d or 7d."]}},"exampleRequest":{"chain":"ethereum","timeframe":"1h","token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a-LfkMCWvEe14ye8-5Mx5","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_Ak-E03R5QyQXbhGV5BZG4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves Token God Mode (TGM) flow intelligence data showing token movement patterns and capital flows from smart money wallets","exampleAgentPrompt":"Pull up Nansen's Token God Mode flow intelligence for USDC on Ethereum — I want to see where smart money is flowing in and out over the last 24 hours.","exampleUseCases":[{"title":"Detect whale accumulation patterns","prompt":"Check the Token God Mode flow data for SOL — are whales and smart money wallets net buying or distributing right now? I want to see the inflow vs outflow breakdown over the past week."},{"title":"Spot institutional DeFi token moves","prompt":"Pull up the TGM flow intelligence for UNI on Ethereum. I'm trying to figure out if any institutional or smart money wallets have been quietly accumulating or offloading over the last 48 hours."},{"title":"Compare exchange vs smart money flows","prompt":"Get me the Nansen flow intelligence for WBTC — I want to see how exchange flows compare to smart money wallet flows, and whether the net movement is pointing toward accumulation or distribution lately."}],"resultDescription":"Returns flow intelligence data including token inflows and outflows from labeled smart money wallets, capital movement breakdowns, and directional signals indicating whether sophisticated wallet clusters are accumulating or distributing a given token.","failureModes":["Invalid or unrecognized token address returns 400 error","Unsupported chain returns error or empty result","Missing required token parameter returns validation error","Rate limiting or payment failure via x402 returns 402","Token with insufficient on-chain activity may return sparse or empty flow data"],"whenToPreferThis":"Use this endpoint when you need deep on-chain flow intelligence specifically tied to Nansen's proprietary smart money wallet labels — ideal when you want to know what sophisticated or institutional wallets are doing with a specific token, as opposed to generic volume or price data. Prefer this over generic DEX aggregators when directional smart money signal is the goal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:54:28.358Z","isFirstParty":false}