# Heurist Mesh: Yahoo Finance Options Chain

> Heurist Mesh: Yahoo Finance Options Chain is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Returns a compact options chain snapshot for a single underlying symbol and expiration date, including bounded contract rows with open-interest and volume summaries.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/agents/YahooFinanceAgent/options_chain
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-yahoo-finance-options-chain-514aec70
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_evU_JFolgFdaoYk-kr4yv

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability heurist-mesh-yahoo-finance-options-chain-514aec70 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-yahoo-finance-options-chain-514aec70/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)