Yahoo Finance API endpoint
Returns price points for a Yahoo Finance `symbol`: open, high, low, close, adjusted close and volume with timestamps. Use `period` (default `1mo`, up to `max`) or `start` and `end`, which override it. `interval` sets the candle size (default `1d`; intraday covers recent ranges only). `include_actions` adds dividend, split and capital-gain `events`.
/yahoo-finance/ticker/{symbol}/historyReturns OHLCV points (open, high, low, close, adjusted close, volume) from Yahoo Finance chart data.
Path parameters: symbol.
Query parameters: optional period, start, end, interval, include_prepost,
include_actions, auto_adjust, back_adjust, keepna, and rounding.
period selects a preset range. Allowed values: 1d, 5d, 1mo, 3mo,
6mo, 1y, 2y, 5y, 10y, ytd, max. Default 1mo. Ignored when
start is set. max returns the full available history; with a daily
interval it reaches the symbol's first trading day, so you can pull a
company's entire price history (e.g. all the way back to its IPO) in one call.start and end select an explicit window as Unix seconds, RFC3339, or
YYYY-MM-DD. When either is set it overrides period.interval sets the candle size. Allowed values: 1m, 2m, 5m, 15m,
30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo. Default 1d.
Intraday intervals only cover recent ranges.To pull the complete price history of a company, request period=max with a
daily-or-coarser interval (or pass an early start).
| Field | Filled in, of 22 checked | Values in the sample |
|---|---|---|
| timestamp | 22 | 2026-09-14 to 2026-10-13 |
| datetime | 22 | 2026-09-14 to 2026-10-13 |
| open | 22 | 330 to 344.67, median 335.28 |
| high | 22 | 331.78 to 348.15, median 338.61 |
| low | 22 | 325.81 to 341.12, median 331.65 |
| close | 22 | 329.4 to 343.45, median 336.13 |
| adj_close | 22 | 329.4 to 343.45, median 336.13 |
| volume | 22 | 21,403,588 to 86,588,200, median 34,400,900 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| symbol (path) | string | Yes | Yahoo Finance symbol such as AAPL | AAPL | |
| period | string | No | Range such as 1d, 1mo, 1y, max | ||
| start | string | No | Unix seconds, RFC3339, or YYYY-MM-DD | ||
| end | string | No | Unix seconds, RFC3339, or YYYY-MM-DD | ||
| interval | string | No | Interval such as 1d, 1h, 5m | ||
| include_prepost | boolean | No | Include pre/post market data | ||
| include_actions | boolean | No | Include dividends, splits, and capital gains | ||
| auto_adjust | boolean | No | Adjust OHLC prices with adjusted close | ||
| back_adjust | boolean | No | Back-adjust OHLC prices while keeping close | ||
| keepna | boolean | No | Keep fully empty chart rows | ||
| rounding | boolean | No | Round prices to two decimals | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/yahoo-finance/ticker/AAPL/history?include_prepost=true&include_actions=true&auto_adjust=true&back_adjust=true&keepna=true&rounding=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"symbol": "AAPL",
"points": [
{
"timestamp": 1779111000,
"open": 210,
"close": 211,
"volume": 54200000
}
]
}
}Request schema
No body schema
Response schema
#/definitions/yahoofinance.historyResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | yahoofinance.HistoryResponse | No | ||||
| data.events | object | No | Dividends, splits and capital gains in the period. Present when actions were requested. | |||
| data.events.capital_gains | array | No | Capital gain distributions in the period. | |||
| data.events.dividends | array | No | Dividend payments in the period. | |||
| data.events.splits | array | No | Stock splits in the period. | |||
| data.meta | object | No | Metadata about the instrument and the price series, as Yahoo Finance reports it. | |||
| data.points | array | No | Price candles in time order. | |||
| data.points[].adj_close | number | No | 211 | Closing price adjusted for dividends and splits. | ||
| data.points[].close | number | No | 211 | Closing price of the candle. | ||
| data.points[].datetime | string | No | 2026-05-18T13:30:00Z | Start of the candle, in UTC (RFC 3339). | ||
| data.points[].high | number | No | 212 | Highest price of the candle. | ||
| data.points[].low | number | No | 209 | Lowest price of the candle. | ||
| data.points[].open | number | No | 210 | Opening price of the candle. | ||
| data.points[].timestamp | integer | No | 1779111000 | Start of the candle, in Unix seconds. | ||
| data.points[].volume | integer | No | 54200000 | Number of shares traded during the candle. | ||
| data.symbol | string | No | AAPL | Ticker symbol, for example `AAPL`. | ||
| 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/history?include_prepost=true&include_actions=true&auto_adjust=true&back_adjust=true&keepna=true&rounding=true" \
-H "x-api-key: $CRAWLORA_API_KEY"