{"uid":"cap_1ylep6BfPDqMD4L1wphfo","slug":"nansen-ai-top-tokens-by-nansen-score-d5492040","name":"Nansen AI - Top Tokens by Nansen Score","description":"Get Nansen Score Top Tokens","url":"https://api.nansen.ai/api/v1/nansen-score/top-tokens","method":"GET","headers":{},"bodySchema":{"type":"object","title":"NansenScoreTopTokensRequest","properties":{"limit":{"type":"integer","title":"Limit","default":25,"maximum":1000,"minimum":1,"examples":[25,50,10],"description":"Maximum number of tokens to return (1-1000)"},"market_cap_group":{"anyOf":[{"enum":["lowcap","midcap","largecap"],"type":"string","title":"MarketCapGroup","description":"Enum for market cap groups."}],"examples":["largecap","midcap","lowcap"],"description":"Filter by market cap category: lowcap (<100M), midcap (100M-1B), largecap (>1B)"}},"description":"Request model for Nansen Score Top Tokens endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"NansenScoreTopTokensResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"NansenScoreToken","required":["chain","token_address","performance_score","risk_score","price_momentum_performance","chain_fees_performance","trading_range_performance","chain_tvl_performance","protocol_fees_performance","btc_reflexivity_risk","liquidity_risk","concentration_risk","inflation_risk"],"properties":{"chain":{"enum":["arbitrum","avalanche","base","bitcoin","bnb","chiliz","ethereum","hyperevm","injective","linea","mantle","mantra","monad","near","optimism","plasma","polygon","ronin","scroll","sei","solana","sonic","stacks","sui","tron","viction"],"type":"string","title":"NansenScoreTopTokensChain","description":"Chains supported for the Nansen Score top-tokens endpoint."},"market_cap":{"anyOf":[{"type":"number"}],"title":"Market Cap","examples":[1500000000,468266714],"description":"Token market cap in USD (with FDV fallback)"},"risk_score":{"type":"integer","title":"Risk Score","examples":[70,40,10],"description":"Safety score (-60 to +80). Sum of risk indicator contributions. Safety threshold: > 0"},"latest_date":{"anyOf":[{"type":"string","format":"date-time"}],"title":"Latest Date","examples":["2025-12-16T00:00:00Z"],"description":"Most recent calendar date for this token's indicators"},"token_symbol":{"anyOf":[{"type":"string"}],"title":"Token Symbol","examples":["ETH"],"description":"Token ticker symbol"},"token_address":{"type":"string","title":"Token Address","examples":["0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"],"description":"Token contract address"},"inflation_risk":{"type":"integer","title":"Inflation Risk","examples":[10,-10,0],"description":"Points from token_supply_inflation_ema indicator (+10 if low, -10 if high, 0 otherwise)"},"liquidity_risk":{"type":"integer","title":"Liquidity Risk","examples":[20,-20,0],"description":"Points from liquidity_risk indicator (+20 if low, -20 if high, 0 otherwise)"},"last_trigger_on":{"anyOf":[{"type":"string","format":"date-time"}],"title":"Last Trigger On","examples":["2025-12-16T10:30:00Z"],"description":"Most recent signal trigger datetime across all indicators"},"market_cap_group":{"anyOf":[{"type":"string"}],"title":"Market Cap Group","examples":["largecap","midcap","lowcap"],"description":"Market cap category: lowcap (<100M), midcap (100M-1B), largecap (>1B)"},"performance_score":{"type":"integer","title":"Performance Score","examples":[45,30,15],"description":"Alpha score (-60 to +75). Sum of performance indicator contributions. Buying threshold: >= 15"},"concentration_risk":{"type":"integer","title":"Concentration Risk","examples":[10,-10,0],"description":"Points from concentration_risk indicator (+10 if low, -10 if high, 0 otherwise)"},"btc_reflexivity_risk":{"type":"integer","title":"Btc Reflexivity Risk","examples":[40,-20,0],"description":"Points from btc_reflexivity indicator (+40 if low, -20 if high, 0 otherwise)"},"chain_tvl_performance":{"type":"integer","title":"Chain Tvl Performance","examples":[0,-35],"description":"Points from chain_tvl indicator (0 or -35 if bearish)"},"chain_fees_performance":{"type":"integer","title":"Chain Fees Performance","examples":[30,0],"description":"Points from chain_fees indicator (0 or +30 if bullish)"},"protocol_fees_performance":{"type":"integer","title":"Protocol Fees Performance","examples":[0,-25],"description":"Points from protocol_fees indicator (0 or -25 if bearish)"},"trading_range_performance":{"type":"integer","title":"Trading Range Performance","examples":[15,0],"description":"Points from trading_range_detection indicator (0 or +15 if bullish)"},"price_momentum_performance":{"type":"integer","title":"Price Momentum Performance","examples":[30,0],"description":"Points from price_momentum indicator (0 or +30 if bullish)"}},"description":"Token score record (coin_id excluded)."},"title":"Data","description":"List of token score records meeting the thresholds (performance_score >= 15)"}},"description":"Response model for Nansen Score Top Tokens endpoint (coin_id excluded)."},"example":null,"exampleRequest":null,"tags":["x402"],"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":"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_ocL4LgdEptmHBn5eEuLxh","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":"Returns a ranked list of top-scoring tokens based on Nansen's Smart Money analytics, filterable by market cap category and result count.","exampleAgentPrompt":"Show me the top 20 large-cap tokens ranked by Nansen's Smart Money score right now.","exampleUseCases":null,"resultDescription":"A ranked list of up to 1000 tokens with their Nansen scores and associated metadata, filtered by the requested market cap group (lowcap, midcap, or largecap).","failureModes":["Invalid limit value outside 1-1000 range returns validation error","Invalid market_cap_group value returns 400 bad request","Payment not provided or insufficient returns 402 Payment Required","API key or auth failure returns 401/403","Rate limit exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need a ranked leaderboard of tokens by Nansen Smart Money score, especially when filtering by market cap tier (low, mid, large). Prefer this over general token screeners when on-chain smart money signal quality is the primary ranking criterion.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:38:12.539Z","isFirstParty":false}