GEX exposures per 1min

curl --request GET \
  --url https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "charm_per_one_percent_move_dir": "654769081.21",
      "charm_per_one_percent_move_oi": "5124108502049.17",
      "charm_per_one_percent_move_vol": "320909908341.10",
      "gamma_per_one_percent_move_dir": "475681.21",
      "gamma_per_one_percent_move_oi": "65476967081.41",
      "gamma_per_one_percent_move_vol": "12921519098.30",
      "price": "4650",
      "time": "2023-12-13T05:00:41.481Z",
      "vanna_per_one_percent_move_dir": "-342349081.21",
      "vanna_per_one_percent_move_oi": "-54622844772.90",
      "vanna_per_one_percent_move_vol": "-5559678859.12"
    },
    {
      "charm_per_one_percent_move_dir": "654769081.21",
      "charm_per_one_percent_move_oi": "4736293042981.03",
      "charm_per_one_percent_move_vol": "308180334258.50",
      "gamma_per_one_percent_move_dir": "475681.21",
      "gamma_per_one_percent_move_oi": "64220497598.15",
      "gamma_per_one_percent_move_vol": "11924696599.44",
      "price": "4650",
      "time": "2023-12-13T11:29:41.501Z",
      "vanna_per_one_percent_move_dir": "-342349081.21",
      "vanna_per_one_percent_move_oi": "-52107741026.80",
      "vanna_per_one_percent_move_vol": "-5043673317.55"
    }
  ]
}

{
  "code": "authentication_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "expected_format": "uuid",
  "message": "The API token provided is not in the expected format. Unusual Whales API tokens are UUIDs, such as 123e4567-e89b-12d3-a456-426614174000.",
  "reason": "malformed_token",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "missing_access",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "The API token provided is valid but is not permitted to access this route.",
  "reason": "route_not_permitted",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "msg": "Invalid path input: MSFT12 (valid example: AAPL) - Invalid query input(s): date=2023-02-140 (valid example: date=2024-01-18)",
  "path": "/api/darkpool/MSFT12",
  "query": "date=2023-02-140",
  "url": "localhost:4000/api/darkpool/MSFT12?date=2023-02-140"
}

"Something went wrong"

Gex/Greeks

GEX exposures per 1min

Returns the GEX exposures for the given ticker per minute.

GEX is the assumed $ value of the given greek (ie. gamma) exposure that market makers need to hedge per 1% change of the underlying stock’s price movement. A positive value is long and a negative value is short.

Investors and large funds lower risk and protect their money by selling calls and buying puts. Market makers provide the liquidity to facilitate these trades.

GEX assumes that market makers are part of every transaction and that the bulk of their transactions are buying calls and selling puts to investors hedging their portfolios.

If a market maker has one contract open with a gamma value of 0.05, then if the underlying stock price moves by 1%, that market maker is exposed to $[0.05 * 100 shares * 0.01 * stock price * underlying parameter of the greek variable (for gamma this variable is the stock price)]. The total market maker exposure is calculated by summing up the exposure of all open contracts determined by the daily open interest or by volume.

Market makers profit from the bid-ask spreads and as such, they constantly gamma hedge (they buy and sell shares to keep their positions delta neutral).

Long call positions are positive gamma - as the stock price increases and delta rises (approaches 1), market makers hedge by selling shares, and they buy shares if the stock price decreases and delta falls.

Short put positions are negative gamma - as the stock price increases and delta falls (approaches -1), market makers hedge by buying shares, and they sell shares if the stock price decreases and delta rises.

As such, in the event of large positive gamma, volatility is suppressed as market makers will hedge by buying as the stock price decreases and selling as the stock price increases. And in the event of large negative gamma, volatility is amplified as market makers will hedge by buying as the stock price increases and selling as the stock price decreases.

This data updates about once per minute during the cash session.

For real time streaming of the same data, subscribe to the gex:{TICKER} websocket channel, see https://api.unusualwhales.com/docs/websocket/gex.

GET

api

stock

{ticker}

spot-exposures

GEX exposures per 1min

curl --request GET \
  --url https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.unusualwhales.com/api/stock/{ticker}/spot-exposures")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "charm_per_one_percent_move_dir": "654769081.21",
      "charm_per_one_percent_move_oi": "5124108502049.17",
      "charm_per_one_percent_move_vol": "320909908341.10",
      "gamma_per_one_percent_move_dir": "475681.21",
      "gamma_per_one_percent_move_oi": "65476967081.41",
      "gamma_per_one_percent_move_vol": "12921519098.30",
      "price": "4650",
      "time": "2023-12-13T05:00:41.481Z",
      "vanna_per_one_percent_move_dir": "-342349081.21",
      "vanna_per_one_percent_move_oi": "-54622844772.90",
      "vanna_per_one_percent_move_vol": "-5559678859.12"
    },
    {
      "charm_per_one_percent_move_dir": "654769081.21",
      "charm_per_one_percent_move_oi": "4736293042981.03",
      "charm_per_one_percent_move_vol": "308180334258.50",
      "gamma_per_one_percent_move_dir": "475681.21",
      "gamma_per_one_percent_move_oi": "64220497598.15",
      "gamma_per_one_percent_move_vol": "11924696599.44",
      "price": "4650",
      "time": "2023-12-13T11:29:41.501Z",
      "vanna_per_one_percent_move_dir": "-342349081.21",
      "vanna_per_one_percent_move_oi": "-52107741026.80",
      "vanna_per_one_percent_move_vol": "-5043673317.55"
    }
  ]
}

{
  "code": "authentication_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "expected_format": "uuid",
  "message": "The API token provided is not in the expected format. Unusual Whales API tokens are UUIDs, such as 123e4567-e89b-12d3-a456-426614174000.",
  "reason": "malformed_token",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "missing_access",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "The API token provided is valid but is not permitted to access this route.",
  "reason": "route_not_permitted",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "msg": "Invalid path input: MSFT12 (valid example: AAPL) - Invalid query input(s): date=2023-02-140 (valid example: date=2024-01-18)",
  "path": "/api/darkpool/MSFT12",
  "query": "date=2023-02-140",
  "url": "localhost:4000/api/darkpool/MSFT12?date=2023-02-140"
}

"Something went wrong"

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

ticker

string

required

A single ticker

Example:

"AAPL"

Query Parameters

date

string

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

Example:

"2024-01-18T00:00:00.000Z"

Response

charm_per_one_percent_move_dir

string

The charm 1% move based on directionalized volume

Example:

"-5559678859.12"

charm_per_one_percent_move_oi

string

The charm 1% move based on OI: This is calculated as charm * open interest * 365

Example:

"5124108502049.17"

charm_per_one_percent_move_vol

string

The charm 1% move based on volume: This is calculated as charm * volume * 365

Example:

"320909908341.10"

gamma_per_one_percent_move_dir

string

The gamma 1% move based on directionalized volume

Example:

"-5559678859.12"

gamma_per_one_percent_move_oi

string

The gamma 1% move based on OI: This is calculated as gamma * open interest * price * price

Example:

"65476967081.41"

gamma_per_one_percent_move_vol

string

The gamma 1% move based on volume: This is calculated as gamma * volume * price * price

Example:

"12921519098.30"

price

string

The underlying price used in calculations. NOTE: For any index ticker this will be the current ATM strike.

Example:

"4650"

time

string

The UTC timestamp of the calculation

Example:

"2023-12-13T05:00:41.481Z"

vanna_per_one_percent_move_dir

string

The vanna 1% move based on directionalized volume

Example:

"-5559678859.12"

vanna_per_one_percent_move_oi

string

The vanna 1% move based on OI: This is calculated as vanna * open interest

Example:

"-54622844772.90"

vanna_per_one_percent_move_vol

string

The vanna 1% move based on volume: This is calculated as vanna * volume

Example:

"-5559678859.12"

Last modified on September 29, 2026

Docs

Endpoints

GEX exposures per 1min

Authorizations

Path Parameters

Query Parameters

Response