# x402stock Options Aggregates API

> x402stock Options Aggregates API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns OHLCV bar aggregates (candlestick data) for a specific options contract over a specified time range and timespan

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/options-aggregates/%7Bcontract%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-options-aggregates-api-1927dd21
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GTCSVEuwBdB5FU6nX8eTY

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 x402stock-options-aggregates-api-1927dd21
```

Example prompt: Pull daily OHLCV bar data for the AAPL 195 call expiring 2026-01-16 (contract ticker: O:AAPL260116C00195000) from 2025-01-01 to 2025-12-31, sorted ascending, limit 365, adjusted.

## When to prefer this

Use this endpoint when you need historical price and volume bar data (OHLCV candlesticks) for a specific options contract, especially for backtesting, charting, or technical analysis of derivatives. Prefer this over equity aggregate endpoints when the instrument is a call or put option rather than an underlying stock or ETF. Ideal for agents needing no-account, pay-per-request access to options historical data via USDC on Base.

## Known failure modes

- Invalid or malformed contract ticker returns an error or empty result
- Date range with no trading data returns bars array with count 0
- From date after to date may return error or empty dataset
- Exceeding limit maximum of 50000 returns validation error
- Payment failure (insufficient USDC or x402 error) blocks request
- Non-existent options contract returns empty or error response

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing an array of OHLCV bars (open, high, low, close, volume, VWAP, trade count, timestamp) for the requested options contract over the specified period, along with total bar count, adjusted flag, the contract ticker, data source, and an as-of timestamp.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "multiplier",
      "timespan",
      "from",
      "to",
      "adjusted",
      "sort",
      "limit"
     ],
     "properties": {
      "to": {
       "type": "string",
       "default": "2026-09-15",
       "minLength": 1
      },
      "from": {
       "type": "string",
       "default": "2025-09-15",
       "minLength": 1
      },
      "sort": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string",
       "default": "asc"
      },
      "limit": {
       "type": "integer",
       "default": 5000,
       "maximum": 50000,
       "exclusiveMinimum": 0
      },
      "adjusted": {
       "type": "boolean",
       "default": true
      },
      "timespan": {
       "enum": [
        "minute",
        "hour",
        "day",
        "week",
        "month",
        "quarter",
        "year"
       ],
       "type": "string",
       "default": "day"
      },
      "multiplier": {
       "type": "integer",
       "default": 1,
       "maximum": 50000,
       "exclusiveMinimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "ticker",
      "data",
      "source",
      "as_of"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "bars",
        "count"
       ],
       "properties": {
        "bars": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "open",
           "high",
           "low",
           "close",
           "volume",
           "vwap",
           "trade_count",
           "timestamp"
          ],
          "properties": {
           "low": {
            "type": "number"
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "bars": [
    {
     "low": 192.5,
     "high": 196,
     "open": 193,
     "vwap": 194.8,
     "close": 195.12,
     "volume": 50000000,
     "timestamp": "2026-05-28T04:00:00.000Z",
     "trade_count": 450000
    }
   ],
   "count": 1,
   "adjusted": true
  },
  "as_of": "2026-05-29T20:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-options-aggregates-api-1927dd21/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)