{"uid":"cap_evU_JFolgFdaoYk-kr4yv","slug":"heurist-mesh-yahoo-finance-options-chain-514aec70","name":"Heurist Mesh: Yahoo Finance Options Chain","description":"Return a compact options chain snapshot for one exact Yahoo Finance underlying symbol and one exact expiration returned by options_expirations, with bounded contract rows and high-signal open-interest and volume summaries.","url":"https://mesh.heurist.xyz/x402/agents/YahooFinanceAgent/options_chain","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rGo-EuMlGBitVSHQhlWBw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a compact options chain snapshot for a single underlying symbol and expiration date, including bounded contract rows with open-interest and volume summaries.","exampleAgentPrompt":"Pull me the options chain snapshot for AAPL with the expiration date 2025-01-17 — show me the top contracts with their open interest and volume summaries.","exampleUseCases":[{"title":"Trader scouting high-OI options strikes","prompt":"Show me the options chain for SPY expiring on 2025-03-21 and highlight which strikes have the highest open interest and volume — I want to see where the big money is positioned."},{"title":"Earnings options activity check","prompt":"Grab me a compact options chain snapshot for NVDA for the expiration closest to their next earnings — I want to see the calls and puts with open interest and volume for the top contracts."},{"title":"Portfolio hedging expiry review","prompt":"What does the options chain look like for MSFT expiring on 2025-06-20? Give me the strike prices, open interest, and volume for calls and puts so I can see if there's good liquidity for a hedge."}],"resultDescription":"A compact snapshot of the options chain for the requested symbol and expiration, including call and put contract rows bounded to a manageable count, with strike prices, open interest figures, volume data, and high-signal summaries of where options activity is concentrated.","failureModes":["Invalid or unrecognized Yahoo Finance symbol returns an error or empty result","Expiration date not matching an available expiry (must use one returned by options_expirations) causes a failure","Symbol has no listed options (e.g. non-optionable stocks) returns empty or error","Exceeding rate limits or payment failure returns a 402 or rate-limit error","Network timeout from Yahoo Finance data source causes partial or failed response"],"whenToPreferThis":"Use this endpoint when you need a quick, bounded options chain snapshot for a specific ticker and expiration — especially useful when you already have valid expiration dates from the companion options_expirations endpoint. Prefer this over raw Yahoo Finance scraping when you need structured open-interest and volume summaries in a compact, agent-ready format. Ideal for options flow analysis, earnings plays, and hedging research within an automated agent workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:49:13.608Z","isFirstParty":false}