{"uid":"cap_w966qy3fqZSkCzz2V5eDs","slug":"agents-x402stock-xyz-us-options-chain-lookup-x402stock-c0d74918","name":"US Options Chain Lookup (x402stock)","description":"The options chain for a US-listed underlying: every listed contract with its strike price, expiration date, call or put type, exercise style, contract ticker, and shares per contract. Filter with ?expiration_date=YYYY-MM-DD, ?contract_type=call|put, ?strike_price=, ?expired=true|false, and ?limit=. Use to discover which option contracts exist before pulling price history. From x402stock","url":"https://agents.x402stock.xyz/api/v1/options/{ticker}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":50,"maximum":1000,"exclusiveMinimum":0},"order":{"enum":["asc","desc"],"type":"string","default":"asc"},"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."},"expired":{"type":"boolean"},"strike_price":{"type":"number","exclusiveMinimum":0},"contract_type":{"enum":["call","put"],"type":"string"},"expiration_date":{"type":"string"}}},"responseSchema":{"type":"object","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"}]},"strike":{"anyOf":[{"type":"number"},{"type":"null"}]},"exercise_style":{"anyOf":[{"type":"string"},{"type":"null"}]},"contract_ticker":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"primary_exchange":{"anyOf":[{"type":"string"},{"type":"null"}]},"shares_per_contract":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false},"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"feedback":{"type":"object","required":["endpoint","method","free","note"],"properties":{"free":{"type":"boolean"},"note":{"type":"string"},"method":{"type":"string","const":"POST"},"endpoint":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USD","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.02/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nB5gcBBrEP_rfu43FONhH","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns every listed options contract for a US-listed underlying, including strike, expiration, call/put type, exercise style, contract ticker, and shares per contract, with filters for expiration date, contract type, strike price, and expiry status.","exampleAgentPrompt":"Pull the full options chain for AAPL — show me all call contracts expiring on 2025-06-20, limit to 100 results.","exampleUseCases":[{"title":"Discovering contracts before pricing","prompt":"I want to look up the price history for a specific TSLA put option — can you first get me all put contracts for TSLA expiring on 2025-09-19 so I can find the right contract ticker?"},{"title":"Scanning for near-money strikes","prompt":"Show me all SPY call options with a strike price of 560 that haven't expired yet — I want to see what contracts are listed around that level."},{"title":"Building an options chain dashboard","prompt":"Get me the complete options chain for QQQ — both calls and puts, all expirations, up to 1000 contracts sorted ascending — so I can display it in my trading dashboard."}],"resultDescription":"A JSON object containing the underlying ticker, an as-of timestamp, the source ('x402stock'), and a data object with a count and array of contracts. Each contract includes its contract ticker symbol, type (call/put), strike price, expiration date, exercise style (American/European), shares per contract, primary exchange, and CFI classification code.","failureModes":["Invalid or unrecognized ticker returns empty contract list or error","Unsupported expiration_date format causes a validation error","Strike price of zero or negative rejected by exclusiveMinimum constraint","Limit exceeding 1000 rejected by schema maximum","No contracts match the combined filters — returns count:0 with empty array","Network or upstream x402stock outage returns a 5xx error","Payment failure via x402 prevents the request from completing"],"whenToPreferThis":"Use this endpoint when you need to discover which options contracts exist for a US-listed equity or ETF before fetching price or Greeks data. It is the right first step in any options workflow — retrieve contract tickers here, then use those tickers with price-history endpoints. Prefer this over manual contract ticker construction when you are unsure of exact expiration dates, available strikes, or exercise styles for a given underlying.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T07:02:13.224Z","isFirstParty":false}