Unusual Whales UnusualWhales API

Options Volume

GET https://api.unusualwhales.com/api/stock/{ticker}/options-volume

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

ticker SingleTicker required

A single ticker

Example: AAPL

Query Parameters

limit Default 1 Max 500 Min 1 optional

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

Example: 10 Default: 1
>= 1 <= 500

Responses

200 422 500

Response Body 200 OK

avg_30_day_call_volume Market General Avg 30 Day Call Volume

Avg 30 day call volume.

Example: 679430.000000000000
avg_30_day_put_volume Market General Avg 30 Day Put Volume

Avg 30 day put volume.

Example: 401961.285714285714
avg_3_day_call_volume Market General Avg 3 Day Call Volume

Avg 3 day call volume.

Example: 606258.533333333333
avg_3_day_put_volume Market General Avg 3 Day Put Volume

Avg 3 day put volume.

Example: 436126.833333333333
avg_7_day_call_volume Market General Avg 7 Day Call Volume

Avg 7 day call volume.

Example: 679145.333333333333
avg_7_day_put_volume Market General Avg 7 Day Put Volume

Avg 7 day put volume.

Example: 388676.000000000000
bearish_premium Market General Bearish Premium

The bearish premium is defined as (call premium bid side) + (put premium ask side).

Example: 143198625
bullish_premium Market General Bullish Premium

The bullish premium is defined as (call premium ask side) + (put premium bid side).

Example: 196261414
call_open_interest Market General Call Open Interest

The sum of open interest of all the call options.

Example: 3975333
call_premium Market General Call Premium

The sum of the premium of all the call transactions that executed.

Example: 9908777.0
call_volume Market General Call Volume

The sum of the size of all the call transactions that executed.

Example: 990943
call_volume_ask_side Market General Call Volume Ask Side

The sum of the size of all the call transactions that executed on the ask side.

Example: 417251
call_volume_bid_side Market General Call Volume Bid Side

The sum of the size of all the call transactions that executed on the bid side.

Example: 498271
date Market General Trading day

A trading date in ISO format.

Example: 2023-09-08
net_call_premium Market General Net Call Premium

Defined as (call premium ask side) - (call premium bid side).

Example: -29138464
net_put_premium Market General Net Put Premium

Defined as (put premium ask side) - (put premium bid side).

Example: 23924325
put_open_interest Market General Put Open Interest

The sum of the open interest of all the put options.

Example: 3564153
put_premium Market General Put Premium

The sum of the premium of all the put transactions that executed.

Example: 163537151
put_volume Market General Put Volume

The sum of the size of all the put transactions that executed.

Example: 808326
put_volume_ask_side Market General Put Volume Ask Side

The sum of the size of all the put transactions that executed on the ask side.

Example: 431791
put_volume_bid_side Market General Put Volume Bid Side

The sum of the size of all the put transactions that executed on the bid side.

Example: 314160
Try It GET
Path Parameters
Query Parameters
Request Sample 
curl -X GET "https://api.unusualwhales.com/api/stock/{ticker}/options-volume" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response Example 200 
{
  "data": [
    {
      "avg_30_day_call_volume": "658450.333333333333",
      "avg_30_day_put_volume": "481505.300000000000",
      "avg_3_day_call_volume": "949763.000000000000",
      "avg_3_day_put_volume": "756387.333333333333",
      "avg_7_day_call_volume": "878336.000000000000",
      "avg_7_day_put_volume": "580650.857142857143",
      "bearish_premium": "138449839",
      "bullish_premium": "152015294",
      "call_open_interest": 4358631,
      "call_premium": "208699280",
      "call_volume": 1071546,
      "call_volume_ask_side": 486985,
      "call_volume_bid_side": 514793,
      "date": "2023-09-08",
      "net_call_premium": "122015294",
      "net_put_premium": "108449839",
      "put_open_interest": 3771656,
      "put_premium": "125472872",
      "put_volume": 666386,
      "put_volume_ask_side": 298282,
      "put_volume_bid_side": 318834
    }
  ]
}