{"uid":"cap_X30uWIT6hqjzDal93JI1R","slug":"x402stock-options-chain-lookup-73e59bab","name":"x402stock Options Chain Lookup","description":"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.","url":"https://x402stock.xyz/api/v1/options/%7Bticker%7D","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","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"}]},"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}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5y8rRhIB3NO1eQwuUBWRF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns options contracts (calls and puts) for a given US stock or ETF ticker, filterable by type, strike, expiration, and whether contracts are expired.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Find SPY put options expiring soon","prompt":"Pull all put options for SPY that expire before the end of this year and haven't expired yet — I want to see the strike prices and expiration dates so I can evaluate some downside protection plays."},{"title":"Look up NVDA call options by strike","prompt":"Show me unexpired call options for NVDA with a strike price between $100 and $150, and list them sorted by expiration date so I can see what's available across the nearest expirations."},{"title":"Get TSLA options chain for specific date","prompt":"Fetch the full options chain for TSLA — both calls and puts — expiring in January 2026, and include the exercise style and contract details for each one."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T12:48:48.467Z","isFirstParty":false}