{"uid":"cap_lupw7GCT9lznGkAnrC0ag","slug":"crypto-openverbs-com-historical-token-price-series-c4d9a931","name":"crypto.openverbs.com Historical Token Price Series","description":"Historical USD price series for one token by coin id (e.g. \"coingecko:bitcoin\", \"ethereum:0xdAC17…\"). Returns evenly spaced `points` over the last `span` periods.","url":"https://crypto.openverbs.com/v1/history","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["coin"],"properties":{"coin":{"type":"string","description":"Coin id: \"coingecko:{slug}\" (e.g. \"coingecko:bitcoin\") or \"{chain}:{tokenAddress}\" (e.g. \"ethereum:0xdAC17F958D2ee523a2206206994597C13D831ec7\")."},"span":{"type":"integer","maximum":365,"minimum":1,"description":"Number of data points to return (default 30)."},"period":{"enum":["1h","1d","1w"],"type":"string","description":"Spacing between points: \"1h\", \"1d\" (default) or \"1w\"."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"coin":"coingecko:bitcoin","found":true,"stale":false,"period":"1d","points":[{"price":77421.5,"timestamp":1788285050}],"source":"defillama","symbol":"BTC","decimals":null,"confidence":0.99}},"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_BCQEGcVFDZ3hPoirkdWHv","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 an evenly-spaced historical USD price series for a single crypto token over a configurable span and period (hourly, daily, or weekly).","exampleAgentPrompt":"Can you pull me the daily historical USD prices for Bitcoin (coingecko:bitcoin) for the last 90 days so I can chart the trend?","exampleUseCases":[{"title":"Crypto portfolio performance review","prompt":"Show me the daily USD price history for Ethereum over the last 365 days — I want to see how it's trended over the past year."},{"title":"DeFi token price trend analysis","prompt":"Fetch the hourly price series for the last 48 hours for the USDT stablecoin using ethereum:0xdAC17F958D2ee523a2206206994597C13D831ec7 so I can check for any depeg events."},{"title":"Weekly price chart for a small-cap token","prompt":"Get me the weekly USD price data for Chainlink (coingecko:chainlink) over the last 52 weeks so I can build a long-term chart."}],"resultDescription":"An array of evenly-spaced historical USD price data points for the requested token, covering the specified number of periods (up to 365) at the chosen granularity (hourly, daily, or weekly). Each point includes a timestamp and a USD price value.","failureModes":["Unknown or invalid coin id returns an error (e.g. typo in coingecko slug or unrecognized chain:address)","span out of range (must be 1–365) returns a validation error","period value not in allowed enum ('1h','1d','1w') returns a validation error","Token with insufficient historical data may return fewer points than requested","Payment failure (x402) if USDC balance is insufficient","Rate limiting or upstream data provider outage may cause transient 5xx errors"],"whenToPreferThis":"Use this endpoint when you need a time-series of historical USD prices for a single token at a specific granularity (hourly, daily, or weekly) — ideal for charting, backtesting, trend analysis, or volatility calculations. Prefer this over the current-price endpoint when you need more than one data point. Choose coingecko:{slug} for well-known tokens and {chain}:{tokenAddress} for ERC-20 or other on-chain tokens not indexed by name.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:22.636Z","isFirstParty":false}