{"uid":"cap_RitUY6z9fZg6Fn9E2ko0C","slug":"agent402-perpetuals-ohlcv-klines-1228ada8","name":"Agent402 Perpetuals OHLCV Klines","description":"OHLCV candles for one perpetual at any interval from 1 minute to 1 month, up to the venue's history, with a window summary of open, close, change, high, low and volume. Use it when an agent needs price history for a chart, a backtest or an indicator without an exchange account or API key.","url":"https://agent402.tools/api/perp-klines","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"coin":{"type":"string","description":"Perp ticker, e.g. BTC, ETH, SOL."},"limit":{"type":"number","description":"Candles to return (default 100, max 500)."},"interval":{"type":"string","description":"Candle interval (default 1h): 1m 3m 5m 15m 30m 1h 2h 4h 8h 12h 1d 3d 1w 1M."}}},"responseSchema":{"type":"json","example":{"coin":"ETH","count":24,"source":"hyperliquid","candles":[{"c":2429.3,"h":2431,"l":2415.5,"o":2420.1,"t":"2026-08-22T11:00:00.000Z","v":1234.5,"trades":8800}],"summary":{"low":2370.1,"high":2440,"open":2380.3,"close":2429.3,"volume":30000.2,"changePct":2.06},"interval":"1h","fetchedAt":"2026-08-22T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wDPceRHETNqHWgto5Xfil","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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 perpetual futures contracts from Hyperliquid, with configurable interval and candle count.","exampleAgentPrompt":"Pull the last 24 hourly candles for ETH perp so I can see the recent price action — open, high, low, close, and volume for each candle.","exampleUseCases":[{"title":"Crypto trading bot price check","prompt":"Fetch the last 100 one-hour candles for BTC perp — I need the OHLCV data to run my momentum strategy."},{"title":"Daily volatility range analysis","prompt":"Get me the past 30 daily candles for SOL perpetuals so I can calculate the average daily trading range and see how volatile it's been."},{"title":"Recent price summary for ETH perp","prompt":"What does the 4-hour candle chart look like for ETH perp over the last 50 candles? I want to see the overall open, close, high, low and percent change summary."}],"resultDescription":"Returns a JSON object with the ticker symbol, candle count, source (Hyperliquid), an array of OHLCV candles each containing open, high, low, close, timestamp, volume, and trade count, plus a summary with overall high, low, open, close, total volume, and percentage change over the requested period, along with the interval and fetch timestamp.","failureModes":["Invalid coin ticker returns an error or empty candle set","Limit exceeding 500 is rejected or capped","Unsupported interval string returns a validation error","Hyperliquid data source unavailable causes a fetch failure","Network timeout on large candle requests"],"whenToPreferThis":"Use this endpoint when you need historical or recent OHLCV candlestick data specifically for perpetual futures contracts sourced from Hyperliquid, paid per-call with no API key required. Prefer this over spot price feeds when you need structured candle arrays with interval flexibility (1m to 1M) and a built-in summary. Best for trading agents, technical analysis workflows, and volatility monitoring on perp markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:59:52.290Z","isFirstParty":false}