{"uid":"cap_GRZ-nv1E29eoKIpOpD67P","slug":"nansen-historical-token-quant-scores-950e22b5","name":"Nansen Historical Token Quant Scores","description":"Get Historical Token Quant Scores (Beta)","url":"https://api.nansen.ai/api/v1beta1/tgm/historical-token-quant-scores","method":"GET","headers":{},"bodySchema":{"type":"object","title":"TgmHistoricalTokenQuantScoresRequest","required":["as_of_date","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."},"as_of_date":{"type":"string","title":"As Of Date","format":"date","examples":["2025-06-01"],"description":"Date to query indicators for"},"token_address":{"type":"string","title":"Token Address","examples":["0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"],"description":"Token contract address"}},"description":"Request model for the historical token quant scores endpoint.\n\nReturns point-in-time Nansen Score indicators for a token anchored to as_of_date.","additionalProperties":false},"responseSchema":{"type":"object","title":"TgmHistoricalTokenQuantScoresResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"TgmHistoricalTokenQuantScore","required":["indicator_type"],"properties":{"score":{"anyOf":[{"type":"string"}],"title":"Score","examples":["bullish"],"description":"Qualitative score label"},"signal":{"anyOf":[{"type":"number"}],"title":"Signal","examples":[0.75],"description":"Raw indicator signal value"},"model_type":{"anyOf":[{"type":"string"}],"title":"Model Type","examples":["reward"],"description":"Whether indicator measures risk or reward"},"is_stablecoin":{"anyOf":[{"type":"boolean"}],"title":"Is Stablecoin","examples":[false],"description":"Whether the token is classified as a stablecoin"},"indicator_type":{"type":"string","title":"Indicator Type","examples":["price-momentum"],"description":"Indicator type identifier"},"market_cap_usd":{"anyOf":[{"type":"number"}],"title":"Market Cap Usd","examples":[500000000],"description":"Token market cap in USD at as_of_date"},"last_trigger_on":{"anyOf":[{"type":"string","format":"date-time"}],"title":"Last Trigger On","examples":["2025-05-28T00:00:00"],"description":"Timestamp of last signal trigger"},"market_cap_group":{"anyOf":[{"type":"string"}],"title":"Market Cap Group","examples":["large"],"description":"Market cap group used for percentile ranking"},"signal_percentile":{"anyOf":[{"type":"number"}],"title":"Signal Percentile","examples":[82.5],"description":"Signal percentile vs same market cap group (0-100)"}},"description":"Single token quant score indicator record for a given date."},"title":"Data","description":"List of token quant score indicators"}},"description":"Response model for the historical token quant scores endpoint."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XCnhxzqdXFGuD7jPDZIcf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical quantitative scores for a specific token on a given chain as of a specified date, powered by Nansen's Smart Money analytics.","exampleAgentPrompt":"Pull up the Nansen historical quant scores for token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum as of 2024-11-01 — I want to see how it was scoring on Smart Money indicators back then.","exampleUseCases":null,"resultDescription":"A set of quantitative scores and indicators for the specified token on the given chain as of the requested date, derived from Nansen's 500M+ labeled address dataset and Smart Money analytics — likely including momentum, holder quality, flow, and other onchain health metrics.","failureModes":["Invalid or unsupported chain returns an error or empty result","Token address not found or not tracked by Nansen returns no data","Future or out-of-range as_of_date may return an error","Missing required parameters (chain, token_address, as_of_date) returns a validation error","Rate limiting or payment failure returns 402 or 429"],"whenToPreferThis":"Use this endpoint when you need point-in-time historical quantitative scores for a specific token, particularly when evaluating smart money signals, onchain health, or token quality for a past date. Prefer this over real-time endpoints when backtesting strategies or researching how a token was rated historically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:34.013Z","isFirstParty":false}