{"uid":"cap_saeHnwBdYBntS7q2ZGdPm","slug":"x402stock-hyperliquid-spot-ohlcv-candles-a350829b","name":"x402stock Hyperliquid Spot OHLCV Candles","description":"Historical OHLCV candles for one Hyperliquid spot market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w) over a time window. Pass a token symbol (e.g. HYPE, PURR) or @index and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or `?start=`/`?end=` epoch-ms. Spot candles — for perp candles use /api/v1/perps/candles/{coin}. From x402stock","url":"https://agents.x402stock.xyz/api/v1/spot/candles/:token?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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","token":{"type":"string"}},"queryParams":{"type":"object","properties":{"end":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"start":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"interval":{"enum":["1m","3m","5m","15m","30m","1h","2h","4h","8h","12h","1d","3d","1w","1M"],"type":"string","default":"1h"},"lookback":{"type":"integer","default":200,"maximum":5000,"exclusiveMinimum":0}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QvHtSU-icBuyEZxd8zFFI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical OHLCV candlestick data for a Hyperliquid spot market token at a specified interval and time window","exampleAgentPrompt":"Pull the last 500 hourly OHLCV candles for HYPE on the Hyperliquid spot market so I can analyze the recent price trend.","exampleUseCases":[{"title":"Crypto momentum strategy backtesting","prompt":"Get me the last 1000 daily candles for HYPE on Hyperliquid spot so I can backtest a moving-average crossover strategy."},{"title":"Real-time price chart rendering","prompt":"Fetch the last 200 five-minute OHLCV candles for PURR on Hyperliquid spot — I need to render a live candlestick chart."},{"title":"Volatility analysis over specific window","prompt":"Pull Hyperliquid spot candles for HYPE at a 4-hour interval from January 1 2025 to March 31 2025 so I can calculate realized volatility over that period."}],"resultDescription":"An array of OHLCV candlestick objects for the requested Hyperliquid spot token, each containing open, high, low, close, and volume values along with a timestamp, covering the specified interval and lookback window or start/end time range.","failureModes":["Invalid or unknown token symbol returns an error or empty result","lookback exceeding 5000 candles is rejected","Invalid interval string returns a validation error","start/end epoch-ms values out of range or inverted may return empty data","Network or upstream Hyperliquid API unavailability causes 5xx errors","Requesting candles for a perp market via this endpoint returns incorrect or no data — use /api/v1/perps/candles/:coin instead"],"whenToPreferThis":"Use this endpoint when you need historical OHLCV candlestick data specifically for Hyperliquid spot markets. It supports flexible time windowing via lookback count or epoch-ms start/end, and a wide range of intervals from 1-minute to weekly. For Hyperliquid perpetuals candles, use the sibling perp candles endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:52.631Z","isFirstParty":false,"canonicalSlug":"x402stock-hyperliquid-spot-ohlcv-candles-a350829b"}