{"uid":"cap_PqjNApmNotVH4zhGL9rwj","slug":"hyperliquid-markets-candles-5d0d27e6","name":"Hyperliquid Markets Candles","description":"Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).","url":"https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/markets/candles","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","description":"Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"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":"down","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_haZInlaNzHmo6gR0ykah_","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":"Fetches OHLCV candlestick data for Hyperliquid perpetual markets, computed from first-party node fills data","exampleAgentPrompt":"Pull 1-hour OHLCV candles for BTC perpetuals on Hyperliquid for the past 7 days so I can analyze recent price action.","exampleUseCases":null,"resultDescription":"Returns OHLCV candlestick records for the requested Hyperliquid perpetual market, including open, high, low, close prices and volume for each interval, computed from first-party node fill data rather than third-party sources.","failureModes":["HTTP 402 if free quota is exhausted and no x402 USDC payment provided","Invalid or unsupported market symbol returns an error","Unsupported candle interval returns an error","Time range too large may result in timeout or truncated response","Malformed JSON body returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need first-party OHLCV candlestick data specifically for Hyperliquid perpetual markets, computed directly from the operator's own node fills ledger rather than aggregated third-party data. Prefer this over generic crypto data providers when you need Hyperliquid-native accuracy, or when building trading analytics, chart visualizations, or backtesting strategies on Hyperliquid perps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T19:28:22.028Z","isFirstParty":false}