Unusual Whales UnusualWhales API

OHLC

GET https://api.unusualwhales.com/api/stock/{ticker}/ohlc/{candle_size}

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

ticker SingleTicker required

A single ticker

Example: AAPL
candle_size string required
enum: 1m, 5m, 10m, 15m, 30m, 1h, 4h, 1d, 1w

Query Parameters

timeframe Time frame optional

The timeframe of the data to return. Can be one of the following formats: - YTD - 1D, 2D, etc. - 1W, 2W, etc. - 1M, 2M, etc. - 1Y, 2Y, etc.

Example: 2M Default: 1Y
end_date OHLC End Date optional

A trading date in the format of YYYY-MM-DD. This is the end date for the given timeframe. If you set the timeframe to 1 minute ticks and have an end_date of 2024-01-18 then it would start searching backwards from 2024-01-18

Example: 2024-01-18
date Market Date optional

A trading date in the format of YYYY-MM-DD.

Example: 2024-01-18
limit Max 2500 Min 1 optional

How many items to return. Max: 2500. Min: 1.

Example: 10
>= 1 <= 2500

Responses

200 422 500

Response Body 200 OK

close Candle Close

The closing price of the candle.

Example: 56.79
end_time Candle End time

The end time of the candle as UTC timestamp.

Example: 2023-09-07T20:07:00Z
high Candle High

The highest price of the candle.

Example: 58.12
low Candle Low

The lowest price of the candle.

Example: 51.90
market_time Market General Market Time

The market time: - pr = premarket - r = regular - po = postmarket

Example: pr
open Candle Open

The opening price of the candle.

Example: 54.29
start_time Candle Start time

The start time of the candle as UTC timestamp.

Example: 2023-09-07T20:06:00Z
total_volume Candle Total volume

The total volume of the ticker for the full trading till now.

Example: 13744676
volume Candle Volume

The volume of the candle.

Example: 10699
Try It GET
Path Parameters
Query Parameters
Request Sample 
curl -X GET "https://api.unusualwhales.com/api/stock/{ticker}/ohlc/{candle_size}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response Example 200 
{
  "data": [
    {
      "close": "56.79",
      "end_time": "2023-09-07T20:11:00Z",
      "high": "56.79",
      "low": "56.79",
      "market_time": "po",
      "open": "56.79",
      "start_time": "2023-09-07T20:10:00Z",
      "total_volume": 13774488,
      "volume": 29812
    },
    {
      "close": "56.79",
      "end_time": "2023-09-07T20:07:00Z",
      "high": "56.79",
      "low": "56.79",
      "market_time": "po",
      "open": "56.79",
      "start_time": "2023-09-07T20:06:00Z",
      "total_volume": 13744676,
      "volume": 10699
    }
  ]
}