{"uid":"cap_SfJyqGWDYqBdmuzqMU3F8","slug":"heurist-mesh-yahoo-finance-options-chain-b898685d","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/solana/agents/YahooFinanceAgent/options_chain","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["symbol"],"properties":{"side":{"type":"string","default":"both","description":"Which side of the chain to return. Ignored when expiration is omitted."},"debug":{"type":"boolean","default":false,"description":"Debug mode flag. ALWAYS use false."},"limit":{"type":"integer","default":12,"description":"Maximum number of expirations to return in discovery mode."},"symbol":{"type":"string","description":"One exact Yahoo Finance underlying symbol such as AAPL, MSFT, or SPY."},"moneyness":{"type":"string","default":"all","description":"Filter contracts by moneyness relative to the underlying spot price. Ignored when expiration is omitted."},"expiration":{"type":"string","description":"Optional expiration date in YYYY-MM-DD format. Omit on the first call to discover expirations. Pass an exact returned value on the second call to return that chain."},"max_strike":{"type":"number","description":"Optional maximum strike filter. Ignored when expiration is omitted."},"min_strike":{"type":"number","description":"Optional minimum strike filter. Ignored when expiration is omitted."},"limit_contracts":{"type":"integer","default":12,"description":"Maximum number of contracts to return per side after filtering. Ignored when expiration is omitted."},"max_days_to_expiration":{"type":"integer","description":"Optional maximum days-to-expiration filter in discovery mode."},"min_days_to_expiration":{"type":"integer","description":"Optional minimum days-to-expiration filter in discovery mode."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"result":{"type":"object","additionalProperties":true}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_NJYIx9KghO3toicpV-5vW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a compact options chain snapshot for a specific underlying symbol and expiration date, including bounded contract rows and open-interest/volume summaries.","exampleAgentPrompt":"Pull me the options chain snapshot for AAPL expiring on 2025-01-17 from Yahoo Finance — show me the calls and puts with open interest and volume summaries, and limit it to the top 20 contracts.","exampleUseCases":[{"title":"Options flow analysis for earnings","prompt":"Get me the full options chain for NVDA expiring on 2025-02-21 — I want to see open interest and volume across strikes so I can spot unusual activity before their earnings."},{"title":"Covered call strike selection","prompt":"Show me the options chain for MSFT expiring 2025-03-21, specifically the call side with open interest and volume — I'm trying to pick a covered call strike around the current price."},{"title":"Put spread research for hedging","prompt":"Fetch the options chain snapshot for SPY with the 2025-04-17 expiration, showing puts with open interest and volume summaries so I can evaluate a put spread hedge."}],"resultDescription":"A compact options chain snapshot containing call and put contract rows (bounded by a row limit) for the specified underlying symbol and expiration date, along with high-signal summaries of open interest and volume across strikes, including bid/ask prices and key Greeks where available.","failureModes":["Invalid or unrecognized Yahoo Finance symbol returns an error or empty result","Expiration date not matching a valid expiry from options_expirations returns an error","Request exceeds contract row bounds causing truncated or rejected response","Network or upstream Yahoo Finance API unavailability causes timeout","Payment of 0.002 USDC not properly included causes 402 rejection"],"whenToPreferThis":"Choose this endpoint when you need a structured, bounded options chain for a specific ticker and expiration date from Yahoo Finance, especially when you want open interest and volume summaries in a compact format suitable for agent consumption. Prefer this over full raw Yahoo Finance scraping when you need clean, LLM-ready output with bounded rows for downstream analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:47:47.537Z","isFirstParty":false}