{"uid":"cap_R4z8MdMLCUYYz8VhoPYkZ","slug":"agents-x402stock-xyz-hyperliquid-spot-ohlcv-candles-ee02105c","name":"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}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["token"],"properties":{"end":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"start":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"token":{"type":"string","description":"Hyperliquid spot token symbol, e.g. PURR."},"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}}},"responseSchema":{"type":"object","required":["source","as_of","venue","market","pair","id","interval","count","candles"],"properties":{"id":{"type":"string"},"pair":{"type":"string"},"as_of":{"type":"string"},"count":{"type":"number"},"venue":{"type":"string"},"market":{"type":"string","const":"spot"},"source":{"type":"string","const":"x402stock"},"candles":{"type":"array","items":{"type":"object","required":["start","end","open","high","low","close","volume","trades"],"properties":{"end":{"anyOf":[{"type":"string"},{"type":"null"}]},"low":{"anyOf":[{"type":"number"},{"type":"null"}]},"high":{"anyOf":[{"type":"number"},{"type":"null"}]},"open":{"anyOf":[{"type":"number"},{"type":"null"}]},"close":{"anyOf":[{"type":"number"},{"type":"null"}]},"start":{"anyOf":[{"type":"string"},{"type":"null"}]},"trades":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"interval":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_53Br1Hd_OreNHtfclyXM4","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns historical OHLCV candlestick data for a Hyperliquid spot market token at a specified interval and time window","exampleAgentPrompt":"Can you pull the last 500 hourly OHLCV candles for HYPE on the Hyperliquid spot market?","exampleUseCases":[{"title":"Crypto trading strategy backtesting","prompt":"Fetch the last 5000 daily candles for HYPE on the Hyperliquid spot market so I can backtest a moving-average crossover strategy."},{"title":"Real-time spot price chart rendering","prompt":"Get the last 200 fifteen-minute candles for PURR on Hyperliquid spot so I can render an up-to-date price chart."},{"title":"Historical range analysis for a token","prompt":"Pull OHLCV candles for HYPE on Hyperliquid spot from January 1 2025 to March 31 2025 at a 1-day interval so I can analyze its quarterly price range."}],"resultDescription":"A JSON object containing the source identifier, as-of timestamp, venue, market type (spot), token pair, interval, candle count, and an array of OHLCV candles each with start time, end time, open, high, low, close, volume, and trade count.","failureModes":["Unknown or invalid token symbol returns an error or empty candle array","Requesting more than 5000 candles via lookback is rejected","Invalid interval enum value returns a validation error","start or end timestamps out of range may return no data","Network or upstream Hyperliquid data unavailability causes a service error","Payment failure via x402 results in 402 response"],"whenToPreferThis":"Use this endpoint when you need historical candlestick price data specifically for Hyperliquid spot markets. Use the companion /api/v1/perps/candles/{coin} endpoint instead for Hyperliquid perpetual futures. Prefer this over generic crypto OHLCV endpoints when the target asset trades on Hyperliquid spot and you need fine-grained control over interval and lookback window without API key setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T06:43:54.333Z","isFirstParty":false}