{"uid":"cap_kieN7AXmJsWldYcUt5T9X","slug":"aiagentoracle-ai-7b387928","name":"AgentOracle Token Price History","description":"AgentOracle: price history time-series for a single token — array of `{ t, price }` points at hourly or daily intervals. Pass `interval=hour` (returns hourly points over last 1-14 days) or `interval=day` (daily points over last 30-365 days). `limit` defaults to 24, max 200. Ideal for trading bots, charting agents, and backtesting.","url":"https://aiagentoracle.ai/api/v1/token/BTC/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"},"pathParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Uppercase ticker symbol."}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":24,"maximum":200,"minimum":1,"description":"Number of points to return (newest last)."},"interval":{"enum":["hour","day"],"type":"string","default":"hour","description":"Time bucket. `hour` returns hourly points; `day` returns daily points."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["symbol","interval","points","asOf"],"properties":{"asOf":{"type":"string","format":"date-time"},"points":{"type":"array","items":{"type":"object","required":["t","price"],"properties":{"t":{"type":"string","format":"date-time"},"price":{"type":"number","description":"Spot price in USD at timestamp `t`."}}}},"symbol":{"type":"string"},"interval":{"enum":["hour","day"],"type":"string"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"symbol":"BTC"},"queryParams":{"limit":24,"interval":"hour"}}},"response":{"asOf":"2026-05-29T04:43:24.848Z","points":[{"t":"2026-05-28T06:00:48.695Z","price":72875.90960868284},{"t":"2026-05-28T07:00:06.782Z","price":73048.6755154588},{"t":"2026-05-28T08:00:20.433Z","price":73337.44824176798},{"t":"2026-05-28T09:00:40.281Z","price":73200.07694076093},{"t":"2026-05-28T10:00:41.776Z","price":73418.1434928209},{"t":"2026-05-28T11:00:34.290Z","price":73306.30442344282},{"t":"2026-05-28T12:00:17.659Z","price":73384.84392551462},{"t":"2026-05-28T13:00:54.903Z","price":73400.04206495249},{"t":"2026-05-28T14:00:47.604Z","price":72898.65501360953},{"t":"2026-05-28T15:00:29.946Z","price":72889.8326730699},{"t":"2026-05-28T16:00:13.790Z","price":72785.65043331202},{"t":"2026-05-28T17:00:33.410Z","price":73303.01923214295},{"t":"2026-05-28T18:00:41.489Z","price":73451.99068403647},{"t":"2026-05-28T19:00:48.955Z","price":73550.79256299682},{"t":"2026-05-28T20:00:49.747Z","price":73343.3487732116},{"t":"2026-05-28T21:00:52.277Z","price":73482.95850574436},{"t":"2026-05-28T22:00:18.186Z","price":73739.61799518361},{"t":"2026-05-28T23:00:17.139Z","price":73370.36217240569},{"t":"2026-05-29T00:00:35.175Z","price":73539.84189606174},{"t":"2026-05-29T01:00:11.039Z","price":73613.0938173537},{"t":"2026-05-29T02:00:50.034Z","price":73490.21978575047},{"t":"2026-05-29T03:00:51.257Z","price":73112.31168568574},{"t":"2026-05-29T04:00:09.565Z","price":73195.82372288709},{"t":"2026-05-29T04:43:18.000Z","price":73306.527911489}],"symbol":"BTC","interval":"hour"}},"exampleRequest":{"limit":24,"interval":"hour"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wBrVfthAjcU6z3vrWyDBw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a time-series array of historical price points (hourly or daily) for a single cryptocurrency token by ticker symbol","exampleAgentPrompt":"Can you pull the hourly price history for BTC over the last 14 days — I need 200 data points to backtest a trading strategy?","exampleUseCases":null,"resultDescription":"A JSON object containing the token symbol, interval type, asOf timestamp, and an array of up to 200 `{ t, price }` points where `t` is an ISO 8601 datetime and `price` is the USD spot price at that time, ordered oldest-to-newest.","failureModes":["Unknown or unsupported ticker symbol returns 404 or empty result","limit exceeding 200 returns validation error","Invalid interval value (not 'hour' or 'day') returns 400 bad request","Payment failure (x402) if USDC not provided or insufficient balance","Rate limiting if too many requests in short period"],"whenToPreferThis":"Use this endpoint when you need historical price time-series data for a specific cryptocurrency token for charting, backtesting, or trend analysis. Choose `interval=hour` for intraday granularity (up to 14 days back) and `interval=day` for longer-term daily trends (up to 365 days). Prefer this over spot-price endpoints when you need multiple price points over time rather than a single current price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:18.723Z","isFirstParty":false}