{"uid":"cap_ARt6xXaCp3iSx_jczL7KU","slug":"token-price-history-daily-or-hourly-usd-series-bde38b3a","name":"Token Price History: Daily or Hourly USD Series","description":"Token price history: daily or hourly USD series up to 1 year — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/defi/token-price-history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"coin":{"type":"string","description":"required: e.g. coingecko:ethereum"},"days":{"type":"integer","maximum":365,"minimum":2,"description":"optional 2-365, default 30"},"period":{"enum":["1d","1h"],"type":"string","description":"optional: 1d (default) | 1h"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"token-price-history","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.003,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"name":"<source>"}],"limitations":"<text>","generated_at":"<iso time>","evidence_hash":"sha256:<64hex>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_03VG2fCxsA_hebLLBhrwf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a time series of USD prices for a cryptocurrency token, at daily or hourly resolution, for up to 1 year","exampleAgentPrompt":"Pull me the daily USD price history for Ethereum (coingecko:ethereum) over the last 90 days so I can analyze its trend.","exampleUseCases":[{"title":"Backtesting a crypto trading strategy","prompt":"Get me the hourly USD price series for Solana (coingecko:solana) over the past 60 days — I want to run a backtesting simulation on it."},{"title":"Portfolio performance review","prompt":"Show me the daily price history in USD for Chainlink (coingecko:chainlink) over the last 365 days so I can see how my portfolio position has performed over the year."},{"title":"DeFi token volatility analysis","prompt":"Fetch the hourly USD prices for Uniswap (coingecko:uniswap) for the last 30 days — I'm trying to measure its recent volatility."}],"resultDescription":"A time series of USD price data points for the specified token, indexed by timestamp, at either daily (1d) or hourly (1h) granularity, covering the requested number of days up to a maximum of 365.","failureModes":["Invalid or unrecognized coin identifier (e.g. missing coingecko: prefix) returns an error","days value outside 2–365 range is rejected","Unsupported period value (not '1d' or '1h') causes a validation error","Token not tracked by the underlying data source returns no data or 404","Payment failure (x402) if USDC is not provided or insufficient"],"whenToPreferThis":"Choose this endpoint when you need historical USD price time series for a specific cryptocurrency token at daily or hourly granularity, especially for DeFi/on-chain analysis workflows. It is well-suited for backtesting, charting, trend analysis, and portfolio performance review, and supports up to 1 year of history. Prefer this over general market data APIs when operating in an x402 micropayment-native agent environment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:55:53.079Z","isFirstParty":false,"canonicalSlug":"token-price-history-daily-or-hourly-usd-series-bde38b3a"}