Crypto OHLC Candles

GET https://api.unusualwhales.com/api/crypto/{pair}/ohlc/{candle_size}

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

pair string required

candle_size string required

enum: 1m, 5m, 10m, 15m, 30m, 1h, 4h, 1d, 1w

Query Parameters

limit Default 500 Max 500 Min 1 optional

How many items to return. Default: 500. Max: 500. Min: 1.

Example: 10 Default: 500

>= 1 <= 500

date Optional Market Date optional

A trading date in the format of YYYY-MM-DD. This is optional and by default the last trading date.

Example: 2024-01-18

Responses

200 422 500

Response Body 200 OK

close string

Example: 93210.00

high string

Example: 94321.00

low string

Example: 89000.00

open string

Example: 90000.00

pair string

Example: BTC-USD

start_time string

Example: 2026-07-29T12:34:00Z

timestamp string

Example: 2026-07-29T12:35:00Z

volume string

Example: 12345.67

Try It GET

API Token

Path Parameters

pair required

candle_size required

Query Parameters

limit Default 500 Max 500 Min 1

date Optional Market Date

Request Sample

curl -X GET "https://api.unusualwhales.com/api/crypto/{pair}/ohlc/{candle_size}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/crypto/{pair}/ohlc/{candle_size}", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "close": "93210.00",
      "high": "94321.00",
      "low": "89000.00",
      "open": "90000.00",
      "pair": "BTC-USD"
    }
  ]
}