{"uid":"cap_4PNoaebUVsvPtA7v8whJk","slug":"hyperextend-ohlcv-candles-api-3e303e26","name":"HyperExtend OHLCV Candles API","description":"OHLCV candles over a window — main, spot, HIP-3 (e.g. xyz:AAPL, xyz:SP500) and HIP-4 outcome markets; intervals 1m to 1d. Priced per row ($0.00001 base for main/spot, $0.000025 premium for HIP-3/HIP-4); paginate with the X-Next-Start header (≤5000 rows/page). Candles lag ~2 days (reconstructed from the archive); omit start/end for the most-recent page.","url":"https://api.hyperextend.xyz/v1/candles/BTC/1m","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","interval"],"properties":{"coin":{"type":"string","description":"Asset symbol, e.g. BTC"},"interval":{"type":"string","description":"Candle interval, e.g. 1m"}}},"queryParams":{"type":"object","required":[],"properties":{"dex":{"type":"string"},"end":{"type":"integer"},"limit":{"type":"integer"},"start":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"coin":"BTC","interval":"1m"},"queryParams":{"limit":50}}},"response":[{"c":"63711.0","h":"63714.0","l":"63708.0","n":123,"o":"63709.0","v":"4.76503","coin":"BTC","interval":"1m","open_time":1781460420000,"close_time":1781460479999},{"c":"63691.0","h":"63728.0","l":"63690.0","n":202,"o":"63711.0","v":"5.18314","coin":"BTC","interval":"1m","open_time":1781460480000,"close_time":1781460539999},{"c":"63715.0","h":"63717.0","l":"63672.0","n":250,"o":"63690.0","v":"6.54198","coin":"BTC","interval":"1m","open_time":1781460540000,"close_time":1781460599999},{"c":"63690.0","h":"63715.0","l":"63682.0","n":186,"o":"63714.0","v":"5.05831","coin":"BTC","interval":"1m","open_time":1781460600000,"close_time":1781460659999},{"c":"63684.0","h":"63693.0","l":"63679.0","n":96,"o":"63690.0","v":"2.13082","coin":"BTC","interval":"1m","open_time":1781460660000,"close_time":1781460719999},{"c":"63694.0","h":"63698.0","l":"63683.0","n":88,"o":"63683.0","v":"1.90577","coin":"BTC","interval":"1m","open_time":1781460720000,"close_time":1781460779999},{"c":"63710.0","h":"63711.0","l":"63693.0","n":125,"o":"63693.0","v":"10.23449","coin":"BTC","interval":"1m","open_time":1781460780000,"close_time":1781460839999},{"c":"63705.0","h":"63710.0","l":"63699.0","n":94,"o":"63710.0","v":"2.1081","coin":"BTC","interval":"1m","open_time":1781460840000,"close_time":1781460899999},{"c":"63711.0","h":"63711.0","l":"63705.0","n":134,"o":"63705.0","v":"10.27298","coin":"BTC","interval":"1m","open_time":1781460900000,"close_time":1781460959999},{"c":"63740.0","h":"63753.0","l":"63710.0","n":157,"o":"63711.0","v":"10.45838","coin":"BTC","interval":"1m","open_time":1781460960000,"close_time":1781461019999},{"c":"63683.0","h":"63740.0","l":"63683.0","n":158,"o":"63739.0","v":"6.29943","coin":"BTC","interval":"1m","open_time":1781461020000,"close_time":1781461079999},{"c":"63672.0","h":"63696.0","l":"63666.0","n":181,"o":"63683.0","v":"6.83009","coin":"BTC","interval":"1m","open_time":1781461080000,"close_time":1781461139999},{"c":"63666.0","h":"63675.0","l":"63651.0","n":203,"o":"63672.0","v":"5.73674","coin":"BTC","interval":"1m","open_time":1781461140000,"close_time":1781461199999},{"c":"63676.0","h":"63680.0","l":"63665.0","n":149,"o":"63666.0","v":"13.00115","coin":"BTC","interval":"1m","open_time":1781461200000,"close_time":1781461259999},{"c":"63673.0","h":"63680.0","l":"63672.0","n":123,"o":"63675.0","v":"5.32714","coin":"BTC","interval":"1m","open_time":1781461260000,"close_time":1781461319999},{"c":"63648.0","h":"63680.0","l":"63648.0","n":185,"o":"63672.0","v":"10.51557","coin":"BTC","interval":"1m","open_time":1781461320000,"close_time":1781461379999},{"c":"63677.0","h":"63680.0","l":"63649.0","n":212,"o":"63649.0","v":"5.77014","coin":"BTC","interval":"1m","open_time":1781461380000,"close_time":1781461439999},{"c":"63699.0","h":"63700.0","l":"63676.0","n":166,"o":"63676.0","v":"8.48733","coin":"BTC","interval":"1m","open_time":1781461440000,"close_time":1781461499999},{"c":"63702.0","h":"63716.0","l":"63690.0","n":278,"o":"63700.0","v":"14.35389","coin":"BTC","interval":"1m","open_time":1781461500000,"close_time":1781461559999},{"c":"63709.0","h":"63712.0","l":"63699.0","n":158,"o":"63701.0","v":"4.84522","coin":"BTC","interval":"1m","open_time":1781461560000,"close_time":1781461619999},{"c":"63687.0","h":"63709.0","l":"63687.0","n":139,"o":"63707.0","v":"4.43129","coin":"BTC","interval":"1m","open_time":1781461620000,"close_time":1781461679999},{"c":"63696.0","h":"63697.0","l":"63677.0","n":265,"o":"63687.0","v":"20.78083","coin":"BTC","interval":"1m","open_time":1781461680000,"close_time":1781461739999},{"c":"63696.0","h":"63702.0","l":"63696.0","n":123,"o":"63697.0","v":"4.00914","coin":"BTC","interval":"1m","open_time":1781461740000,"close_time":1781461799999},{"c":"63734.0","h":"63758.0","l":"63696.0","n":448,"o":"63697.0","v":"81.94737","coin":"BTC","interval":"1m","open_time":1781461800000,"close_time":1781461859999},{"c":"63718.0","h":"63771.0","l":"63717.0","n":396,"o":"63735.0","v":"40.69752","coin":"BTC","interval":"1m","open_time":1781461860000,"close_time":1781461919999},{"c":"63709.0","h":"63718.0","l":"63705.0","n":159,"o":"63717.0","v":"8.48778","coin":"BTC","interval":"1m","open_time":1781461920000,"close_time":1781461979999},{"c":"63713.0","h":"63731.0","l":"63708.0","n":235,"o":"63708.0","v":"4.84625","coin":"BTC","interval":"1m","open_time":1781461980000,"close_time":1781462039999},{"c":"63719.0","h":"63725.0","l":"63714.0","n":93,"o":"63714.0","v":"2.84326","coin":"BTC","interval":"1m","open_time":1781462040000,"close_time":1781462099999},{"c":"63731.0","h":"63731.0","l":"63718.0","n":100,"o":"63719.0","v":"3.25101","coin":"BTC","interval":"1m","open_time":1781462100000,"close_time":1781462159999},{"c":"63742.0","h":"63742.0","l":"63730.0","n":107,"o":"63731.0","v":"5.36384","coin":"BTC","interval":"1m","open_time":1781462160000,"close_time":1781462219999},{"c":"63750.0","h":"63752.0","l":"63736.0","n":89,"o":"63741.0","v":"2.65106","coin":"BTC","interval":"1m","open_time":1781462220000,"close_time":1781462279999},{"c":"63753.0","h":"63754.0","l":"63747.0","n":146,"o":"63750.0","v":"13.53709","coin":"BTC","interval":"1m","open_time":1781462280000,"close_time":1781462339999},{"c":"63762.0","h":"63762.0","l":"63753.0","n":246,"o":"63754.0","v":"12.08198","coin":"BTC","interval":"1m","open_time":1781462340000,"close_time":1781462399999},{"c":"63763.0","h":"63763.0","l":"63761.0","n":599,"o":"63762.0","v":"3.6234","coin":"BTC","interval":"1m","open_time":1781462400000,"close_time":1781462459999},{"c":"63763.0","h":"63768.0","l":"63762.0","n":94,"o":"63763.0","v":"3.25089","coin":"BTC","interval":"1m","open_time":1781462460000,"close_time":1781462519999},{"c":"63757.0","h":"63764.0","l":"63754.0","n":117,"o":"63764.0","v":"4.87561","coin":"BTC","interval":"1m","open_time":1781462520000,"close_time":1781462579999},{"c":"63757.0","h":"63757.0","l":"63756.0","n":95,"o":"63757.0","v":"3.8003","coin":"BTC","interval":"1m","open_time":1781462580000,"close_time":1781462639999},{"c":"63757.0","h":"63757.0","l":"63756.0","n":108,"o":"63757.0","v":"11.02186","coin":"BTC","interval":"1m","open_time":1781462640000,"close_time":1781462699999},{"c":"63761.0","h":"63761.0","l":"63756.0","n":174,"o":"63757.0","v":"16.5675","coin":"BTC","interval":"1m","open_time":1781462700000,"close_time":1781462759999},{"c":"63769.0","h":"63770.0","l":"63760.0","n":118,"o":"63761.0","v":"7.74405","coin":"BTC","interval":"1m","open_time":1781462760000,"close_time":1781462819999},{"c":"63764.0","h":"63788.0","l":"63762.0","n":186,"o":"63770.0","v":"19.92367","coin":"BTC","interval":"1m","open_time":1781462820000,"close_time":1781462879999},{"c":"63785.0","h":"63785.0","l":"63763.0","n":129,"o":"63763.0","v":"4.5815","coin":"BTC","interval":"1m","open_time":1781462880000,"close_time":1781462939999},{"c":"63747.0","h":"63785.0","l":"63747.0","n":145,"o":"63785.0","v":"5.31246","coin":"BTC","interval":"1m","open_time":1781462940000,"close_time":1781462999999},{"c":"63773.0","h":"63774.0","l":"63747.0","n":164,"o":"63747.0","v":"3.75821","coin":"BTC","interval":"1m","open_time":1781463000000,"close_time":1781463059999},{"c":"63776.0","h":"63776.0","l":"63772.0","n":108,"o":"63772.0","v":"5.84185","coin":"BTC","interval":"1m","open_time":1781463060000,"close_time":1781463119999},{"c":"63789.0","h":"63789.0","l":"63775.0","n":111,"o":"63776.0","v":"5.56886","coin":"BTC","interval":"1m","open_time":1781463120000,"close_time":1781463179999},{"c":"63786.0","h":"63789.0","l":"63777.0","n":137,"o":"63788.0","v":"1.91348","coin":"BTC","interval":"1m","open_time":1781463180000,"close_time":1781463239999},{"c":"63777.0","h":"63797.0","l":"63776.0","n":216,"o":"63785.0","v":"24.14224","coin":"BTC","interval":"1m","open_time":1781463240000,"close_time":1781463299999},{"c":"63788.0","h":"63788.0","l":"63776.0","n":106,"o":"63776.0","v":"1.3931","coin":"BTC","interval":"1m","open_time":1781463300000,"close_time":1781463359999},{"c":"63775.0","h":"63788.0","l":"63774.0","n":106,"o":"63788.0","v":"1.95845","coin":"BTC","interval":"1m","open_time":1781463360000,"close_time":1781463419999}]},"exampleRequest":{"limit":50},"tags":["x402"],"displayCostAmount":"0.051","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.051/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.051","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.051","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oskfFGHiLw_BxGrNFKxir","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.051","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns OHLCV (Open, High, Low, Close, Volume) candlestick data for a given crypto asset and interval, optionally filtered by time window.","exampleAgentPrompt":"Can you grab the most recent 1-minute BTC candles from HyperExtend, say the last 50 candles, so I can analyze the recent price action?","exampleUseCases":null,"resultDescription":"A paginated list of OHLCV candlestick records for the requested asset and interval, each containing open, high, low, close, and volume values along with the candle timestamp. Omitting start/end returns the most recent page of candles.","failureModes":["Invalid coin symbol returns an error or empty result","Unsupported interval value causes a 400 bad request","start timestamp after end timestamp results in empty or error response","Requesting too many candles beyond limit cap may return partial data","Payment not provided or insufficient USDC balance causes a 402 response"],"whenToPreferThis":"Choose this endpoint when you need raw OHLCV candlestick price data for a crypto asset at a specific interval (e.g. 1m, 5m) for charting, backtesting, or technical analysis. Prefer this over order book or funding rate endpoints when the primary need is historical or recent price candle data rather than market microstructure metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:40:18.253Z","isFirstParty":false}