Options chain

Option chain for a US-listed ticker: all listed expiration dates, the strike ladder, and per-contract bid/ask/last/volume/open-interest/implied-volatility for calls and puts at one expiry (nearest by default, or pass `expiration` as YYYY-MM-DD). Backed by Yahoo Finance's options endpoint with the session-crumb handshake handled server-side.

Input

Example output

{
  "symbol": "AAPL",
  "underlyingPrice": 232.45,
  "currency": "USD",
  "expiration": "2026-07-17",
  "expirations": [
    "2026-07-17",
    "2026-07-24",
    "2026-08-21"
  ],
  "strikes": [
    220,
    225,
    230,
    235,
    240
  ],
  "calls": [
    {
      "contractSymbol": "AAPL260717C00230000",
      "strike": 230,
      "lastPrice": 4.35,
      "bid": 4.3,
      "ask": 4.45,
      "volume": 1523,
      "openInterest": 8211,
      "impliedVolatility": 0.2431,
      "inTheMoney": true,
      "expiration": "2026-07-17"
    }
  ],
  "puts": [
    {
      "contractSymbol": "AAPL260717P00230000",
      "strike": 230,
      "lastPrice": 1.95,
      "bid": 1.9,
      "ask": 2.02,
      "volume": 987,
      "openInterest": 5410,
      "impliedVolatility": 0.2519,
      "inTheMoney": false,
      "expiration": "2026-07-17"
    }
  ],
  "callCount": 1,
  "putCount": 1
}

Try it — see the 402 challenge (free)

curl -i "https://agent402.tools/api/options-chain?symbol=AAPL"

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/options-chain?symbol=AAPL");

Part of these workflows

This tool is one step in a curated multi-tool workflow — agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.

• Market open brief — Full pre-trade snapshot for one ticker before the bell: the live quote, the pre-market quote, the options surface, dividend posture, and today's market-wide earnings calendar — one payment.

Related tools