{"uid":"cap_Aq4JKku_BZ-oH3_4litZN","slug":"agent402-tools-crypto-price-history-2e81f6ee","name":"agent402.tools Crypto Price History","description":"Historical price, market cap, and volume time series for a coin. Granularity is automatic per CoinGecko: <=1 day = 5-min bars, 2-90 days = hourly, >90 days = daily. Days: 1, 7, 14, 30, 90, 180, 365, or \"max\". Returns aligned arrays of {time, price, marketCap, volume}.","url":"https://agent402.tools/api/crypto-history?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":{"coin":{"type":"string","description":"Symbol (BTC) or id (bitcoin)"},"days":{"type":"string","description":"1, 7, 14, 30, 90, 180, 365, or \"max\" (default 7)"},"currency":{"type":"string","description":"vs_currency (default: usd)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["coin","currency","days","count","bars"],"properties":{"bars":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"price":{"type":"number"},"volume":{"type":"integer"},"marketCap":{"type":"integer"}}}},"coin":{"type":"string"},"days":{"type":"string"},"count":{"type":"integer"},"currency":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"bars":[{"time":"2026-06-13T00:00:00Z","price":66120.45,"volume":27400000000,"marketCap":1298000000000}],"coin":"bitcoin","days":"7","count":1,"currency":"usd"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HJ4OCgJgXmIBE4NA_mbE2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical price, market cap, and volume time series for a cryptocurrency over a specified number of days, with automatic granularity (5-min, hourly, or daily bars).","exampleAgentPrompt":"Can you pull the historical price and market cap data for Bitcoin over the last 30 days in USD — I want to see how it's trended?","exampleUseCases":null,"resultDescription":"Aligned arrays of time series data containing timestamps, prices, market caps, and trading volumes for the requested coin. Granularity is automatically selected by CoinGecko: 5-minute bars for 1-day requests, hourly bars for 2–90 days, and daily bars for more than 90 days.","failureModes":["Invalid or unrecognized coin symbol/id returns an error or empty result","Unsupported 'days' value outside allowed enum (1,7,14,30,90,180,365,max) may return an error","Unsupported vs_currency value may cause an error or fallback","Payment failure (x402) results in 402 response and no data","Rate limiting or CoinGecko upstream outage may cause timeout or 5xx error"],"whenToPreferThis":"Use this endpoint when you need historical cryptocurrency price, market cap, or volume data over a defined time window with automatic granularity. Prefer this over live quote endpoints when trend analysis, charting, or backtesting is needed. Best for agents that need aligned time series arrays rather than a single current snapshot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:51:34.584Z","isFirstParty":false,"canonicalSlug":"agent402-tools-crypto-price-history-2e81f6ee"}