{"uid":"cap_YMweCboPL0wjdg8q3jtRf","slug":"pa1m-hyperliquid-candles-dc7c3648","name":"Pa1m Hyperliquid Candles","description":"Real-time Hyperliquid perpetuals data for AI agents.","url":"https://hyperliquid.hypa1m.xyz/candles/%7Bcoin%7D","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":{"type":"object","required":["coin"],"properties":{"coin":{"type":"string","description":"Coin ticker, e.g. ETH"}}},"queryParams":{"type":"object","required":[],"properties":{"interval":{"type":"string","description":"1m, 5m, 15m, 1h, 4h or 1d"},"lookback":{"type":"integer","description":"Number of candles, max 5000"}}}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"levels":[["67234.5","0.1"]]}},"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_gGpxsrN6Jef4bW7ReX0tl","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 real-time OHLCV candlestick data for a specified coin on the Hyperliquid perpetuals exchange","exampleAgentPrompt":"Pull the latest candle data for BTC on Hyperliquid perps so I can see recent price levels and action.","exampleUseCases":[{"title":"Algorithmic trading signal generation","prompt":"Get me the latest candlestick data for ETH on Hyperliquid perpetuals — I want to check the recent price levels before deciding whether to enter a trade."},{"title":"Real-time perp price monitoring","prompt":"Keep an eye on the SOL perp candles on Hyperliquid and let me know if the price moves more than 2% in either direction from the last close."},{"title":"AI agent market analysis","prompt":"Fetch the current candle data for ARB on Hyperliquid perps and summarize what the price action looks like over the last few periods."}],"resultDescription":"Returns a JSON object containing price levels as an array of [price, size] pairs representing the current candle or order book state for the requested coin on Hyperliquid perpetuals (e.g. {\"levels\": [[\"67234.5\", \"0.1\"]]}).","failureModes":["Invalid or unsupported coin symbol returns an error or empty response","Network timeout if Hyperliquid data feed is unavailable","Payment failure if x402 micropayment of 0.001 USDC is not fulfilled","Rate limiting if too many requests are made in succession","404 if coin path parameter is malformed"],"whenToPreferThis":"Choose this endpoint when you need real-time perpetuals candle or price-level data specifically from the Hyperliquid DEX. It is well-suited for AI agents performing live market analysis, algorithmic trading decisions, or monitoring price movements on Hyperliquid perp markets. Prefer this over generic crypto price APIs when Hyperliquid-specific data (e.g. its unique order book or funding rates context) is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:45:00.259Z","isFirstParty":false}