---
title: "Yahoo Finance options chain"
method: GET
path: "/yahoo-finance/ticker/{symbol}/options"
tags: ["Yahoo Finance"]
---

# Yahoo Finance options chain

`GET /yahoo-finance/ticker/{symbol}/options`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/yahoo-finance/ticker/{symbol}/options`
- Auth: API key in header `x-api-key`

Returns the option expiration dates (`expiration_dates`, as Unix timestamps) and the current option chain for a Yahoo Finance `symbol` such as `AAPL`. Each `options` entry has an `expiration_date` with its `calls` and `puts`; `underlying` describes the underlying security.

## Path parameters

- `symbol` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YahoofinanceOptionsResponseDoc
  - `code` integer
  - `data` YahoofinanceOptionsResponse
    - `expiration_dates` integer[]: Available option expiration dates, in Unix seconds.
    - `options` YahoofinanceOptionExpiration[]: Option chains, one entry per expiration date.
      - `calls` object[]: Call option contracts for this expiration.
      - `expiration_date` integer: Expiration date of the chain, in Unix seconds.
      - `puts` object[]: Put option contracts for this expiration.
    - `symbol` string: Ticker symbol, for example `AAPL`.
    - `underlying` object: Quote data of the underlying stock.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)