Markets and finance

Options chains

The option chain for the symbols you name, one row per contract: the underlying symbol and its price at capture, call or put, the OCC contract symbol, strike, expiration, last price, bid, ask, change and percent change, contract volume, open interest, implied volatility as a number, whether it is in the money, the currency and the last trade time.

Covers as many upcoming expirations per symbol as you ask for. One result, and one billable item, per contract.

When to use it

Use for what the options market is currently pricing: implied volatility across strikes, open interest and unusual volume, put and call skew, or the quote on one specific contract. Rows here are contracts, not symbols, and a single expiration on a liquid US name runs 50 to 400 of them, so maxItems is the ceiling you set on the call. The chain is written calls first in ascending strike order, then puts, per expiration, which means a ceiling smaller than the chain returns low strike calls and no puts at all: ask for one symbol and one expiration when you want a chain you can reason about. Use finance.quote for the underlying snapshot and finance.history for its realised move. Figures come from Yahoo Finance's public feeds rather than from an exchange or an options data vendor, so quotes can be delayed and illiquid contracts can carry stale bids, zero volume and a last price from days ago.

Inputs

Options chains takes 4 fields, 1 of them required. Anything you leave out falls back to the tool's own default.

How to call it

Connect once and your agent can reach Options chains the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.

Or plain HTTP

POST /v1/run

{
  "endpoint": "finance.options",
  "input": {
    "tickers": [
      "AAPL"
    ],
    "maxItems": 200,
    "operation": "options",
    "optionsExpirations": 1
  }
}