{"uid":"cap_q5AyMvsN0YVWNUT_bkFko","slug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-historical-ohlcv-241cc8b5","name":"Hyperliquid Perpetual Futures Historical OHLCV Candles","description":"Historical OHLCV candles for one perpetual-futures market at the requested interval (1m, 5m, 15m, 1h, 4h, 1d, 1w, and more) over a time window. Pass the coin in the path (e.g. BTC) and tune with `?interval=` (default 1h), `?lookback=` candles (default 200, max 5000), or an explicit `?start=`/`?end=` epoch-ms range. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock","url":"https://agents.x402stock.xyz/api/v1/perps/candles/{coin}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["coin"],"properties":{"end":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"coin":{"type":"string","description":"Hyperliquid perpetual coin symbol, e.g. BTC or ETH."},"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}}},"responseSchema":{"type":"object","required":["source","as_of","venue","coin","interval","count","candles"],"properties":{"coin":{"type":"string"},"as_of":{"type":"string"},"count":{"type":"number"},"venue":{"type":"string"},"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_flKF5jy-laLgPej4GCHwa","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 (open, high, low, close, volume) candlestick data for a specified perpetual futures market on Hyperliquid DEX at configurable intervals and time windows.","exampleAgentPrompt":"Pull the last 500 hourly OHLCV candles for BTC perpetual futures from Hyperliquid so I can analyze recent price action.","exampleUseCases":[{"title":"Crypto perp momentum analysis","prompt":"Get me the last 100 four-hour candles for ETH perpetual futures on Hyperliquid so I can check the recent momentum and volatility."},{"title":"Intraday scalping data for SOL perp","prompt":"Fetch 5-minute OHLCV candles for the SOL perpetual futures going back 300 candles — I want to look at intraday price structure."},{"title":"Backtesting daily BTC perp strategy","prompt":"Pull daily OHLCV data for BTC perpetuals from January 1 2024 to June 30 2024 — I need the full open, high, low, close, and volume for each day to backtest a trading strategy."}],"resultDescription":"Returns a JSON object containing the data source, timestamp of the response, venue (Hyperliquid), coin symbol, interval, candle count, and an array of OHLCV candles — each with start/end timestamps, open, high, low, close prices, volume, and trade count.","failureModes":["Invalid coin symbol returns an error or empty candle array","Requesting more than 5000 candles exceeds the maximum lookback limit","Invalid interval value not in the supported enum returns a validation error","Start/end epoch-ms range with no data returns empty candles array","Hyperliquid DEX unavailability may result in stale or missing data","Malformed epoch-ms timestamps (e.g. seconds instead of milliseconds) produce incorrect time windows"],"whenToPreferThis":"Choose this endpoint when you need historical candlestick price data specifically for perpetual futures markets trading on the Hyperliquid DEX. It is the right choice for on-chain perp OHLCV data without requiring API keys, supports flexible intervals from 1-minute to monthly, and allows both lookback-count and explicit date-range queries. Prefer this over spot crypto candle endpoints when the user specifically needs perpetual futures (funding rate exposure, leveraged instruments) rather than spot prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T06:39:18.854Z","isFirstParty":false}