# x402stock Options Aggregates

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

Retrieves aggregated options market data for a specific US options contract, including pricing and related metrics, payable per-request in USDC via x402.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/options-aggregates/%7Bcontract%7D?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-options-aggregates-fb683b9b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qAxZyGsq3dRDvxET397JX

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-fb683b9b
```

Example prompt: Pull the aggregated options data for the AAPL 2025-01-17 $200 call contract from x402stock so I can see the implied volatility, open interest, and volume right now.

## When to prefer this

Choose this endpoint when you need aggregated options data for a specific US options contract (stock or ETF) and want a pay-per-use model with no API key setup. Ideal for AI agents that need on-demand options metrics (IV, OI, volume, premium) for individual contracts. Prefer over subscription-based alternatives when usage is sporadic or when USDC micropayment autonomy is needed.

## Known failure modes

- Invalid or malformed contract identifier returns an error
- Contract not found or not supported in catalog returns 404
- Payment failure or insufficient USDC balance blocks the request
- Expired contracts may return no data or an error
- Rate limiting or service unavailability returns 5xx

## How this service works

Market and economic data for AI agents — US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities (crude, natural gas, gasoline), US and global macro (Fed funds, CPI/PCE, jobs, GDP, Treasury debt & yields, World Bank indicators), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 or MPP. This server is a pay-per-use, transparent proxy in front of x402stock's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.

## Output

Returns aggregated options market data for the specified contract, typically including fields such as implied volatility, open interest, trading volume, bid/ask prices, and contract premium. Data is returned as structured JSON for agent consumption.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## More

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