{"uid":"cap_r2t5iasthE_VG6UjhCXRM","slug":"crypto-price-history-6b650e50","name":"Crypto Price History","description":"Crypto price history: give an asset like ETH, BTC or SOL and up to 365 days, get past USD prices from Chainlink's on-chain feed with times, plus first, last, high, low and change.","url":"https://chain.tollkit.dev/chain/history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"integer","default":7,"maximum":365,"minimum":1},"asset":{"type":"string","description":"Symbol, e.g. \"ETH\", \"BTC\", \"SOL\", \"LINK\"."},"points":{"type":"integer","default":24,"maximum":100,"minimum":2}}},"responseSchema":{"type":"json","example":{"days":7,"feed":"0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419","note":"Each point is a real Chainlink round: the one nearest each evenly spaced time, with the time it was written on-chain. Chainlink writes a new round when the price moves past a set threshold or a set time passes, so high and low are of these points, not every trade.","pair":"ETH / USD","asset":"ETH","chain":"ethereum","points":[{"time":"2026-10-13T07:25:11.000Z","round_id":"129127208515966895888","price_usd":2523.8693},{"time":"2026-10-14T14:00:11.000Z","round_id":"129127208515966895931","price_usd":2452.57},{"time":"2026-10-16T05:04:59.000Z","round_id":"129127208515966896004","price_usd":2451.42},{"time":"2026-10-17T10:31:11.000Z","round_id":"129127208515966896047","price_usd":2433.7582},{"time":"2026-10-18T22:01:23.000Z","round_id":"129127208515966896091","price_usd":2371.0234},{"time":"2026-10-20T06:37:23.000Z","round_id":"129127208515966896135","price_usd":2395.39}],"source":"Chainlink Data Feeds on Ethereum, read on-chain","read_at":"2026-10-20T07:22:34.320Z","summary":{"low_usd":2371.0234,"high_usd":2523.8693,"last_usd":2395.39,"first_usd":2523.8693,"change_pct":-5.09,"latest_round_at":"2026-10-20T06:37:23.000Z"},"explorer_url":"https://etherscan.io/address/0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Al1FQpp4hs0cbs0gH9s-R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical USD prices for a crypto asset (ETH, BTC, SOL, LINK) over up to 365 days, sourced from Chainlink on-chain feeds, with summary statistics including first, last, high, low, and percentage change.","exampleAgentPrompt":"Can you pull up the price history for ETH over the last 30 days from Chainlink's on-chain feed, using 50 data points, and tell me the high, low, and percentage change?","exampleUseCases":[{"title":"Portfolio performance review","prompt":"Show me Bitcoin's price history over the last 90 days — I want to see about 48 data points and know what the high, low, and overall change was."},{"title":"DeFi strategy backtesting","prompt":"Pull the last 365 days of SOL price data from the on-chain Chainlink feed with 100 data points so I can analyze how it's trended over the past year."},{"title":"Crypto volatility snapshot","prompt":"What did LINK's price look like over the past 14 days? Give me 24 data points and summarize the first price, last price, and how much it changed."}],"resultDescription":"Returns an array of timestamped USD price data points for the requested asset over the specified time window, along with summary statistics: first price, last price, highest price, lowest price, and total price change (absolute and/or percentage). Data is sourced from Chainlink's on-chain oracle feeds.","failureModes":["Unsupported asset symbol returns an error or empty result","days or points outside allowed range (1-365, 2-100) causes validation failure","Chainlink feed temporarily unavailable may cause data gaps or errors","Payment failure via x402 protocol blocks the request","Requesting very long history with max points may smooth out granularity significantly"],"whenToPreferThis":"Choose this endpoint when you need verified, on-chain historical crypto price data sourced from Chainlink oracles rather than centralized exchange APIs. Ideal for DeFi analytics, backtesting, or any use case requiring trustworthy blockchain-native price history for ETH, BTC, SOL, or LINK without needing an API key or account setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:08:23.738Z","isFirstParty":false,"canonicalSlug":"crypto-price-history-6b650e50"}