{"uid":"cap_baqS0oHPm7UNhKET2uer7","slug":"aiagentoracle-ai-12582757","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/ETH/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":"ETH"},"queryParams":{"limit":24,"interval":"hour"}}},"response":{"asOf":"2026-05-29T04:43:54.091Z","points":[{"t":"2026-05-28T06:00:46.015Z","price":1974.8025915076523},{"t":"2026-05-28T07:00:39.592Z","price":1980.0319672067262},{"t":"2026-05-28T08:00:15.440Z","price":1991.3682540838242},{"t":"2026-05-28T09:00:47.294Z","price":1985.2400540900992},{"t":"2026-05-28T10:00:22.712Z","price":1990.5745377584412},{"t":"2026-05-28T11:00:45.277Z","price":1988.1472010560992},{"t":"2026-05-28T12:00:37.849Z","price":1986.5922818547647},{"t":"2026-05-28T13:00:53.166Z","price":1988.7556194752497},{"t":"2026-05-28T14:00:49.233Z","price":1978.3293691856506},{"t":"2026-05-28T15:00:12.868Z","price":1989.8155329174415},{"t":"2026-05-28T16:00:18.554Z","price":1986.815424078391},{"t":"2026-05-28T17:00:33.634Z","price":2010.207084769834},{"t":"2026-05-28T18:00:55.283Z","price":2017.31571496479},{"t":"2026-05-28T19:01:14.170Z","price":2022.303049157349},{"t":"2026-05-28T20:00:49.692Z","price":2012.9898344611358},{"t":"2026-05-28T21:00:49.475Z","price":2011.4280055387865},{"t":"2026-05-28T22:00:11.843Z","price":2018.1847851458085},{"t":"2026-05-28T23:00:41.509Z","price":2003.804478708003},{"t":"2026-05-29T00:00:26.112Z","price":2007.5624108851769},{"t":"2026-05-29T01:00:44.119Z","price":2009.348087278078},{"t":"2026-05-29T02:00:49.185Z","price":2005.6130286207288},{"t":"2026-05-29T03:00:37.125Z","price":1996.1507987696975},{"t":"2026-05-29T04:00:37.839Z","price":2000.2332775605416},{"t":"2026-05-29T04:43:43.000Z","price":2003.6520065423592}],"symbol":"ETH","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_KzVeag1l0k0XjRv0Od49-","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 price points (hourly or daily) for a single on-chain crypto token by ticker symbol","exampleAgentPrompt":"Pull the last 168 hourly price points for ETH from AgentOracle so I can chart its price movement over the past week.","exampleUseCases":null,"resultDescription":"A JSON object containing the token symbol, the chosen interval (hour or day), an ISO8601 asOf timestamp, and an array of up to 200 time-price pairs — each with a datetime field `t` and a `price` in USD — ordered oldest to newest.","failureModes":["Unknown ticker symbol returns 404 or empty result","limit exceeding 200 is rejected with a validation error","interval value other than 'hour' or 'day' returns 400 bad request","Payment not provided or insufficient triggers 402 Payment Required","Token exists but has insufficient historical data, returning fewer points than requested"],"whenToPreferThis":"Use this endpoint when you need a historical sequence of price points for a single token for charting, trend analysis, or backtesting — especially when you need configurable granularity (hourly vs daily) and a specific number of data points up to 200. Prefer over spot-price endpoints when time-series data is required rather than just the current price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:38:37.476Z","isFirstParty":false}