{"uid":"cap_awx564pmS_MytlLiboKe6","slug":"nansen-indicators-18347ec8","name":"Nansen Token Risk & Reward Indicators","description":"Get risk and reward indicators for a specific token.\n\nReturns two groups of indicators:\n- **risk_indicators**: Metrics for assessing token risk (btc-reflexivity, liquidity-risk, concentration-risk, token-supply-inflation)\n- **reward_indicators**: Metrics for assessing alpha potential (chain-tvl, trading-range, price-momentum, chain-fees, protocol-fees, cex-flows, funding-rate)\n\nEach indicator includes:\n- **score**: Summary assessment ('low'/'medium'/'high' for risk, 'bearish'/'neutral'/'bullish' for reward)\n- **signal**: Raw metric value\n- **signal_percentile**: Percentile rank (0-100) vs tokens in same market cap group\n- **last_trigger_on**: When the indicator last changed state","url":"https://api.nansen.ai/api/v1/tgm/indicators?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"TGMIndicatorsRequest","required":["chain","token_address"],"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."},"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":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.05","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.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"}]},"paymentMethods":[{"uid":"pm_108ea4UEY2SbfnjMP6Wdi","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Returns scored risk and reward indicators for a specific token on a given blockchain, including metrics like BTC reflexivity, liquidity risk, price momentum, and funding rate.","exampleAgentPrompt":"Can you pull the Nansen risk and reward indicators for the token at 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9 on Ethereum? I want to know if it's showing high liquidity risk, what the price momentum score looks like, and how it ranks against other tokens in its market cap group.","exampleUseCases":[{"title":"Portfolio risk screening across holdings","prompt":"I need to quickly assess the risk profile of my top 10 token positions. Can you pull the risk indicators for each one—especially liquidity risk, concentration risk, and BTC reflexivity—and flag any that are showing 'high' risk scores? I want to know which ones I should be watching closely."},{"title":"Alpha discovery in mid-cap DeFi tokens","prompt":"I'm looking for bullish alpha opportunities in mid-cap DeFi tokens. Can you check the reward indicators—price momentum, funding rate, and chain TVL—for the token at 0x6b175474e89094c44da98b954eedeac495271d0f? How does it rank percentile-wise against other tokens in its market cap bucket?"},{"title":"Smart money flow analysis for trading","prompt":"Show me the latest risk and reward breakdown for this Solana token, especially the price momentum, CEX flows, and funding rate signals. Are these indicators looking bullish or bearish right now, and when did the momentum signal last flip state?"}],"resultDescription":"Returns a structured object with token metadata (market cap, market cap group, stablecoin flag) plus two arrays: risk_indicators (btc-reflexivity, liquidity-risk, concentration-risk, token-supply-inflation) and reward_indicators (chain-tvl, trading-range, price-momentum, chain-fees, protocol-fees, cex-flows, funding-rate). Each indicator includes a categorical score (low/medium/high for risk; bearish/neutral/bullish for reward), a raw signal value, a signal percentile vs tokens in the same market cap cohort, and the date the indicator last changed state.","failureModes":["Unsupported chain returns 422 validation error","Invalid or unrecognized token address returns empty or error response","Token not tracked by Nansen may return null signal values","Rate limiting or insufficient API credits returns 402 or 429","Stablecoin tokens may have limited or less meaningful reward indicators"],"whenToPreferThis":"Use this endpoint when you need a holistic, multi-dimensional risk and reward assessment for a specific token rather than a single metric. Ideal for portfolio risk screening, alpha discovery, or comparing token health across market cap cohorts. Prefer over raw price feeds when you need contextualized, percentile-ranked signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:55.660Z","isFirstParty":false,"canonicalSlug":"nansen-indicators-18347ec8"}