{"uid":"cap_EICnxBjw3z4JLfQehfbIN","slug":"options-contracts-index-by-underlying-47081306","name":"Options Contracts Index by Underlying","description":"Options contract index for an underlying — every listed call/put with option ticker, strike, expiration and exercise style.","url":"https://marketdata.use.x402atlas.com/options-contracts","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":["underlying"],"properties":{"limit":{"type":"integer","maximum":50000,"minimum":1,"description":"Max results returned"},"underlying":{"type":"string","description":"Underlying stock ticker, e.g. AAPL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","underlying","count","contracts"],"properties":{"count":{"type":"integer","description":"Number of contracts returned."},"contracts":{"type":"array","items":{"type":"object","required":["ticker","strike_price"],"properties":{"ticker":{"type":"string","description":"Option ticker, e.g. O:AAPL260117C00150000."},"strike_price":{"type":"number"},"contract_type":{"enum":["call","put"],"type":"string"},"exercise_style":{"type":"string","description":"e.g. american, european."},"expiration_date":{"type":"string","format":"date"},"primary_exchange":{"type":"string"},"underlying_ticker":{"type":"string"},"shares_per_contract":{"type":"number"}}},"description":"Listed option contracts for the underlying."},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp when this bridge queried the upstream."},"underlying":{"type":"string","description":"Echo of the requested underlying ticker."}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"contracts":[{"ticker":"O:AAPL260117C00150000","strike_price":150,"contract_type":"call","exercise_style":"american","expiration_date":"2026-01-17","underlying_ticker":"AAPL","shares_per_contract":100}],"queried_at":"2026-07-06T12:00:00Z","underlying":"AAPL"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nOA2TEGd3Ca6Xi4n2bTiK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a full listing of all call and put options contracts for a given underlying stock ticker, including option tickers, strikes, expirations, and exercise styles.","exampleAgentPrompt":"Can you pull up all listed put options for AAPL — I want to see the full index of strikes and expirations, excluding expired contracts, up to 100 results?","exampleUseCases":null,"resultDescription":"A paginated list of options contracts for the given underlying, each with option ticker symbol, contract type (call/put), strike price, expiration date, and exercise style (American/European).","failureModes":["Missing required 'underlying' parameter returns a 400 validation error","Unknown or invalid ticker symbol may return an empty result set or 404","Requesting more than 1000 results is capped at the max limit","Network or upstream data provider outage may return 5xx errors","Payment failure or insufficient USDC balance returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a comprehensive index of all listed options contracts for a specific underlying — particularly when building an options chain, screening for specific strikes or expirations, or feeding downstream pricing/analytics workflows. Prefer this over a quote or OHLC endpoint when you need contract discovery rather than price data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:47:43.418Z","isFirstParty":false}