{"uid":"cap_0ioHsOU5xVdVPiWMfxhAV","slug":"futures-ohlc-candlestick-aggregates-2a92a7c5","name":"Futures OHLC Candlestick Aggregates","description":"OHLC candlestick bars for a futures contract — historical aggregates with settlement price and dollar volume by contract ticker.","url":"https://marketdata.use.x402atlas.com/futures-aggregates","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"],"type":"string"},"queryParams":{"type":"object","required":["ticker"],"properties":{"to":{"type":"string","format":"date","description":"Range end (YYYY-MM-DD)"},"from":{"type":"string","format":"date","description":"Range start (YYYY-MM-DD)"},"limit":{"type":"integer","maximum":50000,"minimum":1,"description":"Max candles returned"},"ticker":{"type":"string","description":"Futures contract ticker, e.g. ESU5, GCJ5"},"resolution":{"type":"string","pattern":"^[1-9][0-9]*(sec|min|hour|session|week|month|quarter|year)$","description":"Candle size, e.g. 1min, 5min, 1hour, 1session"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","ticker","candles"],"properties":{"ticker":{"type":"string","description":"Echo of the requested contract ticker."},"candles":{"type":"array","items":{"type":"object","required":["time","open","high","low","close","volume"],"properties":{"low":{"type":"number"},"high":{"type":"number"},"open":{"type":"number"},"time":{"type":"string","format":"date-time","description":"Bar start timestamp."},"close":{"type":"number"},"volume":{"type":"number"},"transactions":{"type":"integer"},"dollar_volume":{"type":"number"},"session_end_date":{"type":"string","description":"Trading session end date."},"settlement_price":{"type":"number"}}},"description":"Normalized futures OHLCV bars."},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp when this bridge queried the upstream."},"resolution":{"type":"string","description":"Echo of the requested candle resolution."}}}}}}},"responseSchema":{"type":"json","example":{"ticker":"GCJ5","candles":[{"low":2837.4,"high":2877.1,"open":2849.8,"time":"2025-02-04T00:00:00Z","close":2874.2,"volume":133072,"transactions":74223,"dollar_volume":380560636.01,"session_end_date":"2025-02-04","settlement_price":2875.8}],"queried_at":"2026-07-06T12:00:00Z","resolution":"1session"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4L2TyOJ9-dkDg6jsIspfA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical OHLC candlestick bars (open, high, low, close) with settlement price and dollar volume for a futures contract by ticker and resolution.","exampleAgentPrompt":"Pull me hourly OHLC candlestick bars for ESU5 (S&P 500 futures) from 2025-01-01 to 2025-03-31, up to 500 candles.","exampleUseCases":null,"resultDescription":"Returns a list of OHLC candlestick bar objects for the specified futures contract, each containing open, high, low, close prices, settlement price, dollar volume, and timestamp, aggregated at the requested resolution over the specified date range.","failureModes":["Missing required ticker parameter returns 400 error","Invalid ticker format or unrecognized contract symbol returns empty result or 404","Date range with no trading data (e.g. weekends, holidays) returns empty bars","Invalid resolution string returns 400 validation error","Requesting too many candles beyond limit cap may truncate results","Payment failure (insufficient USDC) returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need historical OHLC candlestick data specifically for futures contracts (e.g. ES, GC, CL, ZC) at configurable time resolutions including intraday and session bars. Prefer this over stock OHLC endpoints when the instrument is a futures contract ticker. Choose this when you need dollar volume alongside price bars or need settlement price data for futures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:56:10.475Z","isFirstParty":false}