Yahoo Finance API endpoint
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.
/yahoo-finance/ticker/{symbol}/options| Field | In the sample | Value in the sample |
|---|---|---|
| symbol | Has a value | “AAPL” |
| expiration_dates | Has a value | 23 entries |
| underlying | Has a value | |
| options | Has a value | 1 entry |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| symbol (path) | string | Yes | Yahoo Finance symbol such as AAPL | AAPL | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yahoo-finance/ticker/AAPL/options" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"symbol": "AAPL",
"expiration_dates": [
1779235200
],
"options": [
{
"expiration_date": 1779235200,
"calls": [],
"puts": []
}
]
}
}Request schema
No body schema
Response schema
#/definitions/yahoofinance.optionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoofinance.OptionsResponse | No | ||||
| data.expiration_dates | array | No | Available option expiration dates, in Unix seconds. | |||
| data.options | array | No | Option chains, one entry per expiration date. | |||
| data.options[].calls | array | No | Call option contracts for this expiration. | |||
| data.options[].expiration_date | integer | No | 1779235200 | Expiration date of the chain, in Unix seconds. | ||
| data.options[].puts | array | No | Put option contracts for this expiration. | |||
| data.symbol | string | No | AAPL | Ticker symbol, for example `AAPL`. | ||
| data.underlying | object | No | Quote data of the underlying stock. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/yahoo-finance/ticker/AAPL/options" \
-H "x-api-key: $CRAWLORA_API_KEY"