{"uid":"cap_hZcyk5D0joqtjp88m59Mu","slug":"hyperliquid-ohlcv-candles-4f3101a3","name":"Hyperliquid OHLCV Candles","description":"OHLCV candles for one Hyperliquid asset over any interval (1m to 1M), normalized into named fields with RFC3339 timestamps.","url":"https://hyperliquid.use.x402atlas.com/candles?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","interval"],"properties":{"end":{"type":"integer","minimum":0,"description":"Optional end (ms epoch); defaults to now"},"coin":{"type":"string","maxLength":32,"description":"Asset symbol (e.g. BTC)"},"start":{"type":"integer","minimum":0,"description":"Optional start (ms epoch); defaults to ~500 intervals ago"},"interval":{"enum":["1m","3m","5m","15m","30m","1h","2h","4h","8h","12h","1d","3d","1w","1M"],"type":"string","description":"Candle interval"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"coin":{"type":"string"},"count":{"type":"integer","description":"Number of candles returned"},"candles":{"type":"array","items":{"type":"object","properties":{"low":{"type":"string","description":"Low price (string for full precision)"},"high":{"type":"string","description":"High price (string for full precision)"},"open":{"type":"string","description":"Open price (string for full precision)"},"close":{"type":"string","description":"Close price (string for full precision)"},"trades":{"type":"integer","description":"Number of trades in the candle"},"volume":{"type":"string","description":"Volume (string for full precision)"},"open_time":{"type":"string","format":"date-time"},"close_time":{"type":"string","format":"date-time"}}}},"interval":{"type":"string"},"queried_at":{"type":"string","format":"date-time","description":"When this response was generated"}}}}}}},"responseSchema":{"type":"json","example":{"coin":"BTC","count":1,"candles":[{"low":"63900.0","high":"64300.0","open":"64000.0","close":"64250.0","trades":987,"volume":"1234.5","open_time":"2026-07-10T11:00:00Z","close_time":"2026-07-10T12:00:00Z"}],"interval":"1h","queried_at":"2026-07-10T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_Q2VnXJWTPq0zyzpzYu6cp","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 OHLCV candlestick data for a single Hyperliquid asset at a chosen interval (1m to 1M), with RFC3339 timestamps and full-precision price/volume strings.","exampleAgentPrompt":"Can you pull 1-hour OHLCV candles for BTC on Hyperliquid for the past week so I can do some technical analysis?","exampleUseCases":null,"resultDescription":"A JSON object containing the coin symbol, interval, count of candles returned, the timestamp when the query was made, and an array of candle objects each with open, high, low, close, volume (all as full-precision strings), trade count, open_time, and close_time in RFC3339 format.","failureModes":["Missing required 'coin' or 'interval' parameters returns a validation error","Invalid coin symbol (not listed on Hyperliquid) returns an empty candle array or error","Invalid interval value returns a schema validation error","Start timestamp after end timestamp may return empty results or an error","Very large time ranges may return truncated or empty data","Payment failure (x402) blocks the request before execution"],"whenToPreferThis":"Use this endpoint when you need structured, named-field OHLCV candlestick data for a specific Hyperliquid asset at a defined interval, especially when RFC3339 timestamps and full-precision price strings are required. Prefer this over generic market data APIs when the asset trades on Hyperliquid (perps or spot) and you need interval flexibility from 1-minute to 1-month.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:42:52.319Z","isFirstParty":false,"canonicalSlug":"hyperliquid-ohlcv-candles-4f3101a3"}