{"uid":"cap_7TCIyexIN8h88cgKW3Ief","slug":"api-nansen-ai-e5a4773e","name":"Nansen Score Indicators","description":"Get Nansen Score Indicators","url":"https://api.nansen.ai/api/v1/tgm/indicators","method":"GET","headers":{},"bodySchema":{"type":"object","title":"TGMIndicatorsRequest","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."},"token_address":{"type":"string","title":"Token Address","examples":["0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"],"description":"Token contract address"}},"description":"Request model for TGM Indicators endpoint.\n\nThis endpoint provides risk and reward indicators for a specific token.","additionalProperties":false},"responseSchema":{"type":"object","title":"TGMIndicatorsResponse","required":["token_address","chain","token_info","risk_indicators","reward_indicators"],"properties":{"chain":{"type":"string","title":"Chain","examples":["ethereum"],"description":"Blockchain chain"},"token_info":{"type":"object","title":"TGMIndicatorTokenInfo","properties":{"is_stablecoin":{"anyOf":[{"type":"boolean"}],"title":"Is Stablecoin","examples":[false],"description":"Flag indicating if token is a stablecoin"},"market_cap_usd":{"anyOf":[{"type":"number"}],"title":"Market Cap Usd","examples":[1500000000],"description":"Market capitalization in USD"},"market_cap_group":{"anyOf":[{"type":"string"}],"title":"Market Cap Group","examples":["largecap","midcap","lowcap"],"description":"Market cap classification group"}},"description":"Token metadata from indicator data."},"token_address":{"type":"string","title":"Token Address","examples":["0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"],"description":"Token contract address"},"risk_indicators":{"type":"array","items":{"type":"object","title":"TGMIndicator","required":["indicator_type"],"properties":{"score":{"anyOf":[{"type":"string"}],"title":"Score","examples":["bullish","high","neutral","low"],"description":"Summary score (risk: low/medium/high, reward: bearish/neutral/bullish)"},"signal":{"anyOf":[{"type":"number"}],"title":"Signal","examples":[0.75,-0.25],"description":"The raw signal value for the indicator"},"indicator_type":{"type":"string","title":"Indicator Type","examples":["btc-reflexivity","liquidity-risk","price-momentum"],"description":"The type of indicator"},"last_trigger_on":{"anyOf":[{"type":"string"}],"title":"Last Trigger On","examples":["2025-01-15"],"description":"Date when the indicator last changed state (YYYY-MM-DD)"},"signal_percentile":{"anyOf":[{"type":"number"}],"title":"Signal Percentile","examples":[85.5,42.3],"description":"Percentile of the signal against tokens in the same market cap group (0-100)"}},"description":"Individual indicator record."},"title":"Risk Indicators","description":"Risk assessment indicators (btc-reflexivity, liquidity-risk, concentration-risk, token-supply-inflation)"},"reward_indicators":{"type":"array","items":{"type":"object","title":"TGMIndicator","required":["indicator_type"],"properties":{"score":{"anyOf":[{"type":"string"}],"title":"Score","examples":["bullish","high","neutral","low"],"description":"Summary score (risk: low/medium/high, reward: bearish/neutral/bullish)"},"signal":{"anyOf":[{"type":"number"}],"title":"Signal","examples":[0.75,-0.25],"description":"The raw signal value for the indicator"},"indicator_type":{"type":"string","title":"Indicator Type","examples":["btc-reflexivity","liquidity-risk","price-momentum"],"description":"The type of indicator"},"last_trigger_on":{"anyOf":[{"type":"string"}],"title":"Last Trigger On","examples":["2025-01-15"],"description":"Date when the indicator last changed state (YYYY-MM-DD)"},"signal_percentile":{"anyOf":[{"type":"number"}],"title":"Signal Percentile","examples":[85.5,42.3],"description":"Percentile of the signal against tokens in the same market cap group (0-100)"}},"description":"Individual indicator record."},"title":"Reward Indicators","description":"Reward/alpha potential indicators (chain-tvl, trading-range, price-momentum, chain-fees, protocol-fees, cex-flows, funding-rate)"}},"description":"Response model for TGM Indicators endpoint.\n\nContains risk and reward indicators grouped separately."},"example":{"request":{"chain":"ethereum","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"},"response":{"chain":"ethereum","token_info":{"is_stablecoin":true,"market_cap_usd":76148027713,"market_cap_group":"largecap"},"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","risk_indicators":[{"score":"low","signal":0.01,"indicator_type":"btc-reflexivity","last_trigger_on":"2026-04-12","signal_percentile":20.516499282639884},{"score":"low","signal":-0.10426672667400087,"indicator_type":"token-supply-inflation","last_trigger_on":"2026-05-29","signal_percentile":18.86120996441281}],"reward_indicators":[{"score":"bullish","signal":1,"indicator_type":"funding-rate","last_trigger_on":"2026-05-22","signal_percentile":4.545454545454546},{"score":"bearish","signal":10,"indicator_type":"trading-range","last_trigger_on":"2026-05-18","signal_percentile":75.35211267605634}]}},"exampleRequest":{"chain":"ethereum","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"},"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_UoO8j1oJ_EmlbffX8oyI7","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_vinaXJeNKJ_tkD4FZOf0H","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":"Returns Nansen Score indicator data for token/wallet analytics via the Token God Mode (TGM) intelligence layer","exampleAgentPrompt":"Pull the Nansen Score indicators for token address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I want to see the smart money scoring signals and TGM intelligence data.","exampleUseCases":null,"resultDescription":"Returns a set of Nansen Score indicator values derived from Token God Mode (TGM) data, including smart money flow signals, wallet quality scores, and on-chain intelligence metrics for the queried token or address.","failureModes":["Invalid or malformed token/wallet address returns 400 error","Unsupported blockchain network returns error or empty result","Missing required POST body fields returns validation error","Insufficient payment or x402 payment failure blocks the request","Rate limiting returns 429 if too many requests","Token not indexed by Nansen returns empty or null indicators"],"whenToPreferThis":"Choose this endpoint when you need Nansen's proprietary smart money scoring and TGM indicator signals for a specific token or wallet address. It is ideal for on-chain intelligence workflows requiring wallet labeling, smart money flow scores, and token-level Nansen analytics. Prefer this over raw blockchain data endpoints when you need curated institutional-grade scoring rather than raw transaction data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:55:36.573Z","isFirstParty":false}