{"uid":"cap_AiZJAnU_cIkSi_1n-qIzk","slug":"agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetuals-ohlcv-777d00fe","name":"Hyperliquid Perpetuals OHLCV Candles","description":"Historical price candles (OHLCV) of a Hyperliquid perpetual such as BTC, ETH or SOL: open, high, low, close, volume in coins and trade count per bar, newest last. Intervals 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w and more; up to 500 bars (default 50). Read from Hyperliquid's public API. Use for charts, backtests, volatility and trend checks, or as context for a trading agent.","url":"https://agent-data-tools.revmesh2074.workers.dev/hyperliquid/candles?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"bars":{"type":"integer","description":"Number of bars, 1-500 (default 50)"},"coin":{"type":"string","description":"Coin symbol such as BTC, ETH, SOL or HYPE (default BTC)"},"interval":{"type":"string","description":"Bar length: 1m, 3m, 5m, 15m, 30m, 1h (default), 2h, 4h, 8h, 12h, 1d, 3d or 1w"}}},"responseSchema":{"type":"object","properties":{"coin":{"type":"string"},"count":{"type":"number"},"source":{"type":"string"},"candles":{"type":"array","items":{"type":"object","properties":{"low":{"type":"number"},"high":{"type":"number"},"open":{"type":"number"},"time":{"type":"string"},"close":{"type":"number"},"trades":{"type":"number"},"volume":{"type":"number"}}}},"interval":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_G0XMO0m0mX-TLnfmbWCvk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Returns historical OHLCV price candles (open, high, low, close, volume, trade count) for Hyperliquid perpetual futures contracts across configurable intervals and bar counts.","exampleAgentPrompt":"Can you pull the last 100 hourly candles for ETH on Hyperliquid so I can check the recent price trend and volatility?","exampleUseCases":[{"title":"Backtest a crypto trading strategy","prompt":"Get me 500 daily candles for BTC on Hyperliquid so I can backtest a moving average crossover strategy against historical price data."},{"title":"Live trading agent price context","prompt":"Fetch the last 50 one-minute candles for SOL perp on Hyperliquid — I need the open, high, low, close and volume to decide whether to enter a trade right now."},{"title":"Volatility check before options trade","prompt":"Pull 200 four-hour candles for ETH on Hyperliquid so I can calculate recent volatility and see whether the market has been trending or ranging."}],"resultDescription":"A JSON object containing the coin symbol, interval label, total bar count, data source label, and an array of OHLCV candle objects each with timestamp, open, high, low, close, volume (in coins), and trade count — ordered from oldest to newest.","failureModes":["Unsupported coin symbol returns an error or empty candles array","Invalid interval string may cause a bad request response","Requesting more than 500 bars will be capped or return an error","Hyperliquid upstream API unavailability causes a 5xx or timeout","Missing required coin defaults to BTC; missing interval defaults to 1h — may surprise callers expecting a different default"],"whenToPreferThis":"Choose this endpoint when you specifically need OHLCV candlestick data for Hyperliquid perpetual futures markets. It is ideal for trading agents, backtesting pipelines, charting applications, and volatility/trend analysis tasks that require structured historical price bars from Hyperliquid's exchange rather than spot prices or data from other venues.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:21:33.542Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetuals-ohlcv-777d00fe"}