{"uid":"cap_0gQreooF0GgExw5Nb0yAm","slug":"nansen-token-information-b1666f90","name":"Nansen Token Information (TGM)","description":"Get comprehensive token information including basic details (name, symbol, contract address, logo), token details (deployment date, social links, market metrics like market cap and FDV), and spot trading metrics (volume, buys/sells, unique traders, liquidity, holders).\n\nThis endpoint provides a complete overview of a token's metadata, market position, and trading activity for a specific date range.","url":"https://api.nansen.ai/api/v1/tgm/token-information?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"TGMTokenInformationRequest","required":["chain","token_address","timeframe"],"properties":{"chain":{"enum":["arbitrum","arc","avalanche","base","bnb","ethereum","hyperevm","hyperliquid","injective","iotaevm","linea","mantle","mantra","monad","near","optimism","plasma","polygon","robinhood","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":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_AYdLDVxJEccxDKRlvImDk","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm__P6N1YILeQU3hVR0KvjHN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Returns comprehensive token metadata, market metrics, and spot trading activity for a given token on a specified blockchain over a chosen timeframe.","exampleAgentPrompt":"Pull the full Nansen Token God Mode profile for AAVE at contract 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 on Ethereum — give me the market cap, FDV, total liquidity, buy/sell volumes, unique traders, and holder count for the last 1 day.","exampleUseCases":[{"title":"Evaluate new token project fundamentals","prompt":"I'm looking at a new token launch on Solana — pull me the complete token profile including market cap, FDV, total liquidity, social links, and trading volume for the last 24 hours so I can assess if it's worth tracking."},{"title":"Monitor whale trading activity across chains","prompt":"Show me the buy and sell volumes, unique buyer/seller counts, and liquidity for this token address on Arbitrum over the past 6 hours — I want to see if there's unusual whale activity happening."},{"title":"Compare token health snapshots for portfolio","prompt":"Give me the full snapshot for these three tokens on Base — deployment date, current market cap, total holders, and spot trading metrics from the last week so I can see which ones have the healthiest fundamentals."}],"resultDescription":"A JSON object containing: token name, symbol, logo URL; token details such as deployment date, social links (Twitter/X, Telegram, website), market cap, and FDV; and spot trading metrics including total buy/sell transaction counts, buy/sell volumes in USD, total trading volume, liquidity in USD, unique buyer/seller counts, and total holder count — all scoped to the requested chain and timeframe.","failureModes":["Invalid or unsupported chain enum returns a validation error","Token address not found on the specified chain returns empty or null data fields","Unsupported timeframe enum value causes a 422 validation error","Malformed token address (wrong format) triggers a bad request error","No trading activity in the timeframe returns zero-value spot metrics","Rate limiting or quota exceeded returns a 429 error"],"whenToPreferThis":"Use this endpoint when you need a one-stop comprehensive snapshot of a token — combining metadata (name, symbol, logo, social links, deployment date), market positioning (market cap, FDV), and trading activity (volume, buys, sells, liquidity, holders) in a single call. Prefer this over separate metadata or volume endpoints when you need the full picture for token profiling, due diligence, or dashboard population across any of the 25 supported chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:43:01.218Z","isFirstParty":false,"canonicalSlug":"nansen-token-information-b1666f90"}