# Nansen Token God Mode Flow Intelligence > Nansen Token God Mode Flow Intelligence is a paid API for AI agents from api.nansen.ai, paid per call via MPP or x402, $0.01/call, status unknown (last checked 2026-09-14). Retrieves Token God Mode (TGM) flow intelligence data showing token movement patterns and capital flows from smart money wallets ## Facts - Endpoint: GET https://api.nansen.ai/api/v1/tgm/flow-intelligence - Price: $0.01/call - Payment: MPP, x402 - Status: unknown - Last checked: 2026-09-14 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/api-nansen-ai-2fc8a903 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HcN2C-wUu-OcJ2SUR32on 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 api-nansen-ai-2fc8a903 ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works Get "Token God Mode" (TGM) flow intelligence data ## Output 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. ## Example request ```json { "chain": "ethereum", "timeframe": "1h", "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" } ``` ## Request schema (JSON Schema) ```json { "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": [ … (truncated) ``` ## Response schema (JSON Schema) ```json { "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 … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-nansen-ai-2fc8a903/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)