{"uid":"cap_SMekaB0YOACtz84Xv_vW8","slug":"x402stock-perpetual-futures-ohlcv-candles-6add8979","name":"x402stock Perpetual Futures 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?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":{"coin":{"type":"string"},"type":"object"},"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_lN11bxrk0etA9BWLCLzuc","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 specified perpetual futures market on Hyperliquid DEX at a chosen time interval and lookback window.","exampleAgentPrompt":"Pull the last 500 daily candles for BTC perpetual futures from Hyperliquid so I can analyze the price trend over time.","exampleUseCases":[{"title":"Crypto perp trend analysis","prompt":"Get me the last 200 one-hour candles for ETH perpetual futures on Hyperliquid so I can check the recent price action."},{"title":"Backtesting with historical perp data","prompt":"Fetch 5000 daily candles for BTC perp going back as far as possible from Hyperliquid — I need a long historical dataset to backtest a trading strategy."},{"title":"Short-term intraday scalping data","prompt":"Grab the last 100 five-minute candles for SOL perpetual futures from Hyperliquid starting from epoch 1700000000000 to 1700100000000."}],"resultDescription":"Returns an array of OHLCV candlestick objects for the requested perpetual futures market, each containing open, high, low, close, and volume values along with the candle's timestamp, covering the specified interval and lookback window or explicit time range.","failureModes":["Invalid coin symbol returns an error or empty result","Lookback exceeding 5000 raises a validation error","Invalid interval value not in the supported enum returns an error","Start/end timestamps out of range or malformed return an error","Network or upstream Hyperliquid DEX unavailability causes a timeout or 5xx error"],"whenToPreferThis":"Choose this endpoint when you need free, no-key-required historical OHLCV candlestick data specifically for perpetual futures markets on the Hyperliquid on-chain DEX. It is ideal for technical analysis, backtesting trading strategies, or monitoring price trends across a wide range of intervals from 1-minute to monthly. Prefer it over spot candle endpoints when working with perpetual derivatives rather than spot markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:28:24.244Z","isFirstParty":false,"canonicalSlug":"x402stock-perpetual-futures-ohlcv-candles-6add8979"}