---
title: "Yahoo Finance historical prices"
method: GET
path: "/yahoo-finance/ticker/{symbol}/history"
tags: ["Yahoo Finance"]
---

# Yahoo Finance historical prices

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

## Request

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

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`.

## Path parameters

- `symbol` string, required

## Query parameters

- `period` string
- `start` string
- `end` string
- `interval` string
- `include_prepost` boolean
- `include_actions` boolean
- `auto_adjust` boolean
- `back_adjust` boolean
- `keepna` boolean
- `rounding` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YahoofinanceHistoryResponseDoc
  - `code` integer
  - `data` YahoofinanceHistoryResponse
    - `events` YahoofinanceActionEvents
      - `capital_gains` object[]: Capital gain distributions in the period.
      - `dividends` object[]: Dividend payments in the period.
      - `splits` object[]: Stock splits in the period.
    - `meta` object: Metadata about the instrument and the price series, as Yahoo Finance reports it.
    - `points` YahoofinancePricePoint[]: Price candles in time order.
      - `adj_close` number: Closing price adjusted for dividends and splits.
      - `close` number: Closing price of the candle.
      - `datetime` string: Start of the candle, in UTC (RFC 3339).
      - `high` number: Highest price of the candle.
      - `low` number: Lowest price of the candle.
      - `open` number: Opening price of the candle.
      - `timestamp` integer: Start of the candle, in Unix seconds.
      - `volume` integer: Number of shares traded during the candle.
    - `symbol` string: Ticker symbol, for example `AAPL`.
  - `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)