---
title: "Yahoo Finance batch historical prices"
method: POST
path: "/yahoo-finance/download"
tags: ["Yahoo Finance"]
---

# Yahoo Finance batch historical prices

`POST /yahoo-finance/download`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/yahoo-finance/download`
- Auth: API key in header `x-api-key`

Returns historical prices for up to 25 symbols in one POST. The body requires `symbols`; `period`, `start`, `end`, `interval`, `include_prepost` and `include_actions` are optional. Each result is one symbol, with price points (open, high, low, close, adjusted close, volume) and dividend, split and capital-gain events, or an `error` for that symbol.

## Headers

- `x-api-key` string, required

## Request body

- YahoofinanceDownloadRequest
  - `auto_adjust` boolean
  - `back_adjust` boolean
  - `end` string
  - `include_actions` boolean
  - `include_prepost` boolean
  - `interval` string
  - `keepna` boolean
  - `period` string
  - `rounding` boolean
  - `start` string
  - `symbols` string[], required

## Response `200`

OK

- YahoofinanceDownloadResponseDoc
  - `code` integer
  - `data` YahoofinanceDownloadResponse
    - `results` YahoofinanceDownloadResult[]: One result per requested symbol, in request order.
      - `error` string: Message explaining why the history could not be returned. Omitted on success.
      - `history` 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`.
      - `symbol` string: Ticker symbol this result is for.
  - `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)