{"uid":"cap_G4BkZyNdpJBF1RWr-WsY1","slug":"agent402-tools-options-chain-21e1186c","name":"agent402.tools Options Chain","description":"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.","url":"https://agent402.tools/api/options-chain","method":"GET","headers":{},"bodySchema":{"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":["symbol"],"properties":{"symbol":{"type":"string","description":"US-listed ticker (e.g. AAPL, SPY, TSLA)"},"expiration":{"type":"string","description":"Optional expiry to fetch, YYYY-MM-DD - must be one of the listed expirations (default: nearest)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["symbol","underlyingPrice","currency","expiration","expirations","strikes","calls","puts","callCount","putCount"],"properties":{"puts":{"type":"array"},"calls":{"type":"array"},"symbol":{"type":"string"},"strikes":{"type":"array"},"currency":{"type":"string"},"putCount":{"type":"integer"},"callCount":{"type":"integer"},"expiration":{"type":"string"},"expirations":{"type":"array"},"underlyingPrice":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"puts":[{"ask":2.02,"bid":1.9,"strike":230,"volume":987,"lastPrice":1.95,"expiration":"2026-07-17","inTheMoney":false,"openInterest":5410,"contractSymbol":"AAPL260717P00230000","impliedVolatility":0.2519}],"calls":[{"ask":4.45,"bid":4.3,"strike":230,"volume":1523,"lastPrice":4.35,"expiration":"2026-07-17","inTheMoney":true,"openInterest":8211,"contractSymbol":"AAPL260717C00230000","impliedVolatility":0.2431}],"symbol":"AAPL","strikes":[220,225,230,235,240],"currency":"USD","putCount":1,"callCount":1,"expiration":"2026-07-17","expirations":["2026-07-17","2026-07-24","2026-08-21"],"underlyingPrice":232.45}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wzHNwxUSdZzPhGCk7pu9e","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full option chain for a US-listed ticker: all expiration dates, strike ladder, and per-contract bid/ask/last/volume/open-interest/IV for calls and puts at a given expiry.","exampleAgentPrompt":"Pull the full options chain for SPY — all strikes with bid, ask, volume, open interest, and implied vol for calls and puts — using the nearest expiration date.","exampleUseCases":null,"resultDescription":"A structured response containing: (1) all listed expiration dates for the ticker, (2) the strike ladder for the selected expiry, and (3) per-contract data (bid, ask, last, volume, open interest, implied volatility) for both calls and puts at that expiry. Defaults to the nearest expiration if none is specified.","failureModes":["Invalid or non-US ticker symbol returns an error or empty result","Expiration date not in the listed expirations list returns an error","Malformed date format (not YYYY-MM-DD) causes a validation error","Ticker has no listed options (e.g. thinly traded stocks) returns empty or error","Payment of 0.005 USDC not completed results in 402 Payment Required response","Rate limiting or upstream data provider outage may return 503 or timeout"],"whenToPreferThis":"Use this endpoint when you need real-time options market data for a US-listed equity or ETF, including full strike coverage, Greeks-adjacent metrics (IV), and both calls and puts in a single call. Prefer this over a generic stock price endpoint when the user is researching options strategies, scanning for unusual activity (volume/OI), or needs expiry-level contract detail. The x402 micropayment model makes it suitable for per-query agent workflows without subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-07-22T15:33:26.075Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:56:32.458Z","isFirstParty":false}