{"uid":"cap_VhmUl9nDXZpldAA5TMa20","slug":"agent402-coin-market-chart-range-3a85abf5","name":"Agent402 Coin Market Chart Range","description":"Price, market cap and volume series for a coin over an ARBITRARY time window: `from`/`to` as unix seconds or ISO dates, or `lookback` (\"6h\", \"3d\", \"2w\") ending now. Granularity is automatic upstream: 5-minute points for a window of 1 day or less, hourly up to 90 days, daily beyond. The windowed sibling of crypto-history (which counts days back from now): use it to align with a specific event, a filing date or another series.","url":"https://agent402.tools/api/coin-market-chart-range?utm_source=zero.xyz","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":{"to":{"type":"string","description":"Window end: unix seconds or ISO-8601 date. Default = now."},"coin":{"type":"string","description":"Coin id (bitcoin, ethereum, ...)."},"from":{"type":"string","description":"Window start: unix seconds or ISO-8601 date. Default = to minus 24h."},"currency":{"type":"string","description":"vs currency (default usd)."},"lookback":{"type":"string","description":"Alternative to from: a window ending at `to`, like \"6h\", \"3d\" or \"2w\"."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["source","fetchedAt","cached","coin","currency","from","to","count","granularity","summary","points"],"properties":{"to":{"type":"string"},"coin":{"type":"string"},"from":{"type":"string"},"count":{"type":"integer"},"cached":{"type":"boolean"},"points":{"type":"array"},"source":{"type":"string"},"summary":{"type":"object"},"currency":{"type":"string"},"fetchedAt":{"type":"string"},"granularity":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"to":"2026-08-22T13:20:00.000Z","coin":"ethereum","from":"2026-08-19T13:20:00.000Z","count":73,"cached":false,"points":[{"time":"2026-08-19T14:00:00.000Z","price":2380.1,"volume":13800000000,"marketCap":287000000000}],"source":"coingecko","summary":{"low":2350,"high":2480.1,"last":2424.5,"first":2380.1,"changePct":1.87},"currency":"usd","fetchedAt":"2026-08-22T13:20:00.000Z","granularity":"1h"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VFjeV-6eM71xDR9Rfqsut","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical OHLCV-style price, volume, and market cap data for a cryptocurrency over a specified time window, with summary statistics and configurable granularity.","exampleAgentPrompt":"Can you pull the historical price and volume data for ethereum in USD from August 1st to August 22nd 2026, including the high, low, and percent change summary?","exampleUseCases":[{"title":"Crypto price range research","prompt":"What was Bitcoin's price high, low, and percent change over the last 3 days in USD? Give me the hourly breakdown."},{"title":"Backtesting data pull for trading bot","prompt":"I need historical market cap, price, and volume data for Solana from July 1st to July 31st 2026 in USD — can you fetch that so I can backtest a strategy?"},{"title":"Weekly portfolio performance review","prompt":"Show me Ethereum's price history for the past week — I want to see the first price, last price, and how much it moved in percentage terms."}],"resultDescription":"Returns a JSON object with the queried coin id, from/to timestamps, number of data points, granularity (e.g. 1h), an array of time-series points each containing time, price, volume, and market cap, a summary object with low/high/first/last/changePct values, the currency, data source (CoinGecko), fetchedAt timestamp, and a cached flag.","failureModes":["Unknown coin id returns an error or empty result — use CoinGecko slug format (e.g. 'bitcoin', not 'BTC')","Invalid or unparseable date formats in from/to fields may cause a 400-level error","Requesting very long historical windows may result in coarser granularity or truncated data","If the requested window exceeds available data history, the response may be partial","Network or upstream CoinGecko unavailability may result in a 5xx or timeout response"],"whenToPreferThis":"Choose this endpoint when you need time-series cryptocurrency price, volume, and market cap data over a specific historical range with summary statistics (high, low, change%) included. It is ideal for backtesting, charting, portfolio reviews, or any workflow requiring structured OHLCV-style data for a named coin without managing CoinGecko API keys directly. Prefer it over general crypto tickers when you need range data rather than a single current price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:54:39.733Z","isFirstParty":false,"canonicalSlug":"agent402-coin-market-chart-range-3a85abf5"}