{"uid":"cap_kjdfqZwmkgyzEZhNU_MXP","slug":"api-nansen-ai-cfea133f","name":"Nansen Token God Mode - Token Information","description":"Get \"Token God Mode\" (TGM) token information data","url":"https://api.nansen.ai/api/v1/tgm/token-information","method":"GET","headers":{},"bodySchema":{"type":"object","title":"TGMTokenInformationRequest","required":["chain","token_address","timeframe"],"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."},"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":["0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"],"description":"Token address"}},"description":"Request model for TGM token information endpoint.\nThis endpoint provides comprehensive token information including basic details,\ntoken details (deployment, social links, market metrics), and spot trading metrics.","additionalProperties":false},"responseSchema":{"type":"object","title":"TGMTokenInformationResponse","required":["data"],"properties":{"data":{"type":"object","title":"TGMTokenInformation","properties":{"logo":{"anyOf":[{"type":"string"}],"title":"Logo","examples":["https://assets.coingecko.com/coins/images/12645/large/AAVE.png"],"description":"Token logo URL"},"name":{"anyOf":[{"type":"string"}],"title":"Name","examples":["Aave"],"description":"Token name"},"symbol":{"anyOf":[{"type":"string"}],"title":"Symbol","examples":["AAVE"],"description":"Token symbol"},"spot_metrics":{"anyOf":[{"type":"object","title":"SpotMetrics","properties":{"total_buys":{"anyOf":[{"type":"integer"}],"title":"Total Buys","examples":[666],"description":"Total number of buy transactions"},"total_sells":{"anyOf":[{"type":"integer"}],"title":"Total Sells","examples":[499],"description":"Total number of sell transactions"},"liquidity_usd":{"anyOf":[{"type":"number"}],"title":"Liquidity Usd","examples":[153420000],"description":"Liquidity in USD"},"total_holders":{"anyOf":[{"type":"integer"}],"title":"Total Holders","examples":[165299],"description":"Total number of token holders"},"unique_buyers":{"anyOf":[{"type":"integer"}],"title":"Unique Buyers","examples":[106],"description":"Number of unique buyers"},"buy_volume_usd":{"anyOf":[{"type":"number"}],"title":"Buy Volume Usd","examples":[4520000],"description":"Total buy volume in USD"},"unique_sellers":{"anyOf":[{"type":"integer"}],"title":"Unique Sellers","examples":[132],"description":"Number of unique sellers"},"sell_volume_usd":{"anyOf":[{"type":"number"}],"title":"Sell Volume Usd","examples":[4330000],"description":"Total sell volume in USD"},"volume_total_usd":{"anyOf":[{"type":"number"}],"title":"Volume Total Usd","examples":[8850000],"description":"Total trading volume in USD"}},"description":"Spot trading metrics for the token."}],"description":"Spot trading metrics for the token"},"token_details":{"anyOf":[{"type":"object","title":"TokenDetails","properties":{"x":{"anyOf":[{"type":"string"}],"title":"X","examples":["https://x.com/aave"],"description":"X (Twitter) profile URL"},"fdv_usd":{"anyOf":[{"type":"number"}],"title":"Fdv Usd","examples":[4930000000],"description":"Fully diluted valuation in USD"},"website":{"anyOf":[{"type":"string"}],"title":"Website","examples":["https://aave.com"],"description":"Token website URL"},"telegram":{"anyOf":[{"type":"string"}],"title":"Telegram","examples":["https://t.me/Aavesome"],"description":"Telegram channel URL"},"total_supply":{"anyOf":[{"type":"number"}],"title":"Total Supply","examples":[16000000],"description":"Total supply of the token"},"market_cap_usd":{"anyOf":[{"type":"number"}],"title":"Market Cap Usd","examples":[4690000000],"description":"Market capitalization in USD"},"circulating_supply":{"anyOf":[{"type":"number"}],"title":"Circulating Supply","examples":[15230000],"description":"Circulating supply of the token"},"token_deployment_date":{"anyOf":[{"type":"string"}],"title":"Token Deployment Date","examples":["2020-11-05T00:00:00Z"],"description":"Token deployment date in ISO format"}},"description":"Token details including deployment, social links, and market metrics."}],"description":"Token details including deployment, social links, and market metrics"},"contract_address":{"anyOf":[{"type":"string"}],"title":"Contract Address","examples":["0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"],"description":"Token contract address"}},"description":"Token information including basic details, token details, and spot metrics."}},"description":"Response model for TGM token information endpoint.\nContains comprehensive token information including basic details,\ntoken details, and spot metrics."},"example":null,"exampleRequest":null,"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":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KBQ-ctV9kRUk7C8N1fTC-","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 comprehensive 'Token God Mode' (TGM) information and analytics data for a specific token via Nansen's smart money intelligence platform","exampleAgentPrompt":"Pull up the Nansen Token God Mode information for USDC on Ethereum — I want to see the smart money wallet labels and token analytics.","exampleUseCases":null,"resultDescription":"Returns Token God Mode (TGM) data for the specified token, including smart money holder intelligence, wallet labels, on-chain analytics, and token metrics as tracked by Nansen's proprietary labeling system.","failureModes":["Invalid or unrecognized token contract address returns error","Unsupported blockchain network returns error","Token not indexed by Nansen returns empty or null result","Payment failure (x402) if USDC balance is insufficient","Rate limiting if requests exceed quota"],"whenToPreferThis":"Use this endpoint when you need Nansen's proprietary 'Token God Mode' smart money intelligence for a specific token — particularly when you want wallet labels, smart money holder data, and on-chain analytics that go beyond raw blockchain data. Prefer this over generic on-chain lookups when Nansen's curated wallet labeling and smart money signals are specifically needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:54:26.501Z","isFirstParty":false}