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

# Yahoo Finance options chain by expiration

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

## Request

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

Returns the calls and puts for one expiration of a Yahoo Finance `symbol`. `expiration` is a Unix timestamp, and the options endpoint lists the available ones in `expiration_dates`. The result is an `options` entry with `expiration_date`, `calls` and `puts`.

## Path parameters

- `symbol` string, required
- `expiration` 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/028417aa35bb?raw)