# Futures OHLC Candlestick Aggregates

> Futures OHLC Candlestick Aggregates is a paid API for AI agents from marketdata.use.x402atlas.com, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-13).

Returns historical OHLC candlestick bars (open, high, low, close) with settlement price and dollar volume for a futures contract by ticker and resolution.

## Facts

- Endpoint: GET https://marketdata.use.x402atlas.com/futures-aggregates
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/futures-ohlc-candlestick-aggregates-2a92a7c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0ioHsOU5xVdVPiWMfxhAV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability futures-ohlc-candlestick-aggregates-2a92a7c5
```

Example prompt: Pull me hourly OHLC candlestick bars for ESU5 (S&P 500 futures) from 2025-01-01 to 2025-03-31, up to 500 candles.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

OHLC candlestick bars for a futures contract — historical aggregates with settlement price and dollar volume by contract ticker.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": "stri
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/futures-ohlc-candlestick-aggregates-2a92a7c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from marketdata.use.x402atlas.com](https://www.zero.xyz/host/marketdata.use.x402atlas.com/llms.txt)