{"uid":"cap_ViK8RCUBfPKc91E49vS6y","slug":"agent402-coin-history-historical-cryptocurrency-price-lookup-d567a0bd","name":"Agent402 Coin History - Historical Cryptocurrency Price Lookup","description":"Price, market cap and 24h volume of a coin on ONE past date (00:00 UTC snapshot), in every currency at once plus your chosen one called out. Pass `date` (YYYY-MM-DD) or `daysAgo` (1-365). The point-in-time sibling of crypto-history (which returns a series): use it to value a position as of a date, compute a since-date return, or check a tax-lot basis. Historical range on this plan is the past 365 days, enforced before the call. Cached in-process for 5 minutes.","url":"https://agent402.tools/api/coin-history","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["coin"],"properties":{"coin":{"type":"string","description":"Coin id (bitcoin, ethereum, ...)."},"date":{"type":"string","description":"Snapshot date YYYY-MM-DD (UTC), within the past 365 days. Alternative to daysAgo."},"daysAgo":{"type":"number","description":"Days before today, 1-365 (used when date is absent; default 30)."},"currency":{"type":"string","description":"Currency to call out (default usd); all currencies are still returned under `allCurrencies`."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["source","fetchedAt","cached","id","symbol","name","date","currency","price","marketCap","volume24h","allCurrencies"],"properties":{"id":{"type":"string"},"date":{"type":"string"},"name":{"type":"string"},"price":{"type":"number"},"cached":{"type":"boolean"},"source":{"type":"string"},"symbol":{"type":"string"},"currency":{"type":"string"},"fetchedAt":{"type":"string"},"marketCap":{"type":"integer"},"volume24h":{"type":"integer"},"allCurrencies":{"type":"object"}}}}}}},"responseSchema":{"type":"json","example":{"id":"bitcoin","date":"2026-07-23","name":"Bitcoin","price":118412.55,"cached":false,"source":"coingecko","symbol":"BTC","currency":"usd","fetchedAt":"2026-08-22T13:20:00.000Z","marketCap":2356000000000,"volume24h":41000000000,"allCurrencies":{"price":{"btc":1,"eur":100812.3,"usd":118412.55},"marketCap":{"usd":2356000000000},"volume24h":{"usd":41000000000}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pv1PCBciFdEZY91pMFjRL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a historical price snapshot for a given cryptocurrency on a specific past date, including market cap, 24h volume, and prices in multiple currencies.","exampleAgentPrompt":"What was the price of Bitcoin in USD exactly 30 days ago, and what was its market cap and 24h volume on that date?","exampleUseCases":[{"title":"Crypto portfolio historical valuation","prompt":"I need to know what Ethereum was worth in USD on 2024-06-01 — including its market cap and trading volume that day — so I can calculate what my portfolio was worth at that point."},{"title":"Backtesting a DCA strategy","prompt":"Can you pull the Bitcoin price in EUR for each of the past 7 days so I can see what my dollar-cost averaging entries would have cost me?"},{"title":"Cross-currency price comparison on a past date","prompt":"What was Solana's price in EUR and USD 90 days ago? I want to compare the exchange rate impact on my returns."}],"resultDescription":"Returns a JSON object containing the coin's historical price in the requested currency and all other available currencies, market cap, 24h trading volume, the source (CoinGecko), the snapshot date, whether the result was cached, and the timestamp when it was fetched.","failureModes":["Unknown coin id returns an error or empty result","Date older than 365 days is outside the supported range","Invalid date format (not YYYY-MM-DD) causes a bad request","Unsupported currency code may return null for that currency field","CoinGecko upstream downtime may cause fetch failures or stale cached data"],"whenToPreferThis":"Use this endpoint when you need a historical price snapshot for a specific cryptocurrency on a past date (up to 365 days ago), including multi-currency breakdowns and market cap/volume. Prefer this over live price endpoints when the query is date-specific or retrospective. It is backed by CoinGecko data and requires no API key — payment is per-call via x402/USDC wallet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:47:45.819Z","isFirstParty":false}