# x402stock Options Chain Lookup

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

Returns options contracts (calls and puts) for a given US stock or ETF ticker, filterable by type, strike, expiration, and whether contracts are expired.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/options/%7Bticker%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-options-chain-lookup-73e59bab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X30uWIT6hqjzDal93JI1R

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-chain-lookup-73e59bab
```

Example prompt: Pull the options chain for AAPL — show me up to 100 call contracts expiring after June 2026, sorted in ascending order by expiration date, and only include contracts that haven't expired yet.

## When to prefer this

Use this endpoint when you need structured options chain data (calls, puts, strikes, expirations) for US stocks or ETFs without managing API keys or subscriptions. Ideal for AI agents that need pay-per-call access via USDC on Base, want to filter by contract type, strike, or expiration in a single request, and need standard contract metadata like exercise style and CFI codes.

## Known failure modes

- Invalid or unrecognized ticker returns empty contracts or error
- Payment not sent or insufficient USDC causes 402 Payment Required response
- Invalid contract_type enum value causes validation error
- limit exceeding 1000 or set to 0/negative triggers schema validation failure
- Querying a ticker with no listed options returns count of 0 and empty contracts array
- Network or upstream data provider outage returns 5xx error

## 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 the ticker symbol, an as-of timestamp, the data source, and a list of matching options contracts. Each contract includes its contract ticker symbol (e.g. O:AAPL260620C00150000), type (call or put), strike price, expiration date, exercise style (e.g. American), shares per contract, primary exchange, and CFI code. Also includes a total count of returned contracts.

## 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": [
      "limit",
      "order"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 1000,
       "exclusiveMinimum": 0
      },
      "order": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string",
       "default": "asc"
      },
      "expired": {
       "type": "boolean"
      },
      "strike_price": {
       "type": "number",
       "exclusiveMinimum": 0
      },
      "contract_type": {
       "enum": [
        "call",
        "put"
       ],
       "type": "string"
      },
      "expiration_date": {
       "type": "string"
      }
     },
     "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": [
        "count",
        "contracts"
       ],
       "properties": {
        "count": {
         "type": "number"
        },
        "contracts": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "contract_ticker",
           "type",
           "strike",
           "expiration_date",
           "exercise_style",
           "shares_per_contract",
           "primary_exchange",
           "cfi"
          ],
          "properties": {
           "cfi": {
            "anyOf": [
             {
              "type": "string"
             },
             {
              "type": "null"
             }
            ]
           },
           "type": {
            "anyOf": [
             {
              "type": "string"
             },
             {
              "type": "null"
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 2,
   "contracts": [
    {
     "cfi": "OCASPS",
     "type": "call",
     "strike": 150,
     "exercise_style": "american",
     "contract_ticker": "O:AAPL260620C00150000",
     "expiration_date": "2026-06-20",
     "primary_exchange": "BATO",
     "shares_per_contract": 100
    },
    {
     "cfi": "OPASPS",
     "type": "put",
     "strike": 150,
     "exercise_style": "american",
     "contract_ticker": "O:AAPL260620P00150000",
     "expiration_date": "2026-06-20",
     "primary_exchange": "BATO",
     "shares_per_contract": 100
    }
   ]
  },
  "as_of": "2026-06-01T20:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-options-chain-lookup-73e59bab/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)