{"uid":"cap_ar3BaNqXjVm3RyzhBYeOo","slug":"nansen-token-god-mode-historical-ohlcv-34faaaaa","name":"Nansen Token God Mode Historical OHLCV","description":"Get historical \"Token God Mode\" (TGM) token OHLCV (Beta)","url":"https://api.nansen.ai/api/v1beta1/tgm/historical-token-ohlcv","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string"},"as_of_ts":{"type":"string"},"date_from":{"type":"string"},"timeframe":{"type":"string"},"as_of_date":{"type":"string"},"token_address":{"type":"string"},"apply_blacklist_filter":{"type":"boolean"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"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":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-7VITOcXTj4bglvNIQeRS","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 historical OHLCV (open, high, low, close, volume) price data for a token using Nansen's Token God Mode dataset, with configurable timeframes and optional blacklist filtering","exampleAgentPrompt":"Can you pull the historical Token God Mode OHLCV data for token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum with daily resolution starting from 2024-01-01 through 2024-06-30?","exampleUseCases":null,"resultDescription":"A time-series array of OHLCV (open, high, low, close, volume) candlestick records for the specified token, filtered to the requested chain, date range, and timeframe resolution. Optionally excludes blacklisted tokens when the filter is enabled.","failureModes":["Invalid or unsupported chain name returns an error","Malformed token contract address returns a validation error","Unsupported timeframe value returns an error","date_from later than as_of_date results in empty or error response","Token not found on specified chain returns empty result","API key missing or invalid returns 401/403","Hyperliquid chain requires coin symbol instead of contract address — passing an address will fail","blacklist filter applied with non-daily/weekly timeframe returns an error"],"whenToPreferThis":"Use this endpoint when you need structured historical OHLCV candlestick data for a specific on-chain token, particularly when you want Nansen's curated Token God Mode dataset with optional blacklist filtering. Prefer this over generic price APIs when you need chain-specific data, support for Hyperliquid, or Nansen's smart-money data quality standards.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:45:01.759Z","isFirstParty":false}