{"uid":"cap_vvLG66sdYyqwd70ThdAT4","slug":"hyperliquid-data-market-candles-8a93a4a0","name":"Hyperliquid-data Market Candles","description":"First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).","url":"https://hyperliquid-data.v1337.org/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_XYPQZPtwROvt9e_Lqm9iV","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 Hyperliquid perpetual markets, computed from first-party node fills ledger data","exampleAgentPrompt":"Pull me 1-hour OHLCV candles for BTC-USDC perpetual on Hyperliquid for the last 7 days so I can run a technical analysis.","exampleUseCases":null,"resultDescription":"Returns an array of OHLCV candlestick records for the specified Hyperliquid perpetual market and time range, each containing open, high, low, close prices, volume, and the candle timestamp — sourced from Hyperliquid's own node fills ledger.","failureModes":["Invalid or unsupported asset symbol returns error","Unsupported candle interval/resolution causes rejection","Time range too large may result in truncated or empty response","Payment not attached or insufficient USDC (x402) results in 402 Payment Required","Malformed JSON body returns 400 Bad Request","Service downtime returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need first-party Hyperliquid perpetual market candlestick (OHLCV) data for chart rendering, backtesting, or technical analysis, and want data sourced directly from Hyperliquid's node fills ledger rather than a third-party aggregator. Prefer this over generic crypto data APIs when Hyperliquid-specific accuracy or perp market coverage is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T21:28:03.230Z","isFirstParty":false}