API Reference

Greeks & Dealer Positioning

Greeks heatmaps and statistics (Basic), the unified Greeks-exposure endpoint that powers GEX/DEX/charm/vanna views (Premium), and the legacy GEX module (currently hidden).

These endpoints use session-cookie auth (the platform UI). For programmatic access with a long-lived API token, see the Bearer-token surface on the MCP / Claude integration page.

Greeks heatmap suite (/api)

Feature key: greeks_heatmap (Basic).

GET /api/greeks_heatmap
Basic greeks_heatmap

Greek value matrices across strikes × expirations for the heatmap view.

Parameters

ticker (required); type ∈ calls | puts | net; max_exps (1–20, default 8); strike_range (% around spot, 1–100, default 20); exp_filter ∈ all | weekly | monthly

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/greeks_heatmap?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/greeks_heatmap", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/greeks_heatmap_historical
Basic greeks_heatmap

Historical Greek matrices for day-over-day comparison.

Parameters

ticker; type; max_exps; strike_range; trade_date (YYYY-MM-DD, optional)

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/greeks_heatmap_historical?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/greeks_heatmap_historical", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/greeks_overlays
Basic greeks_heatmap

Lazy-loaded overlay matrices (second Greek, volume/OI, IV skew) aligned to the base heatmap grid.

Parameters

ticker; type ∈ calls | puts; overlay_greek ∈ delta | gamma | theta | vega | vanna | charm | rho; include_volume_oi, include_iv_skew (booleans); strikes & expirations_raw (JSON arrays from the base heatmap — required)

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/greeks_overlays?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/greeks_overlays", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/greeks_cell_details
Basic greeks_heatmap

Drill-down details for a single heatmap cell.

Parameters

ticker, strike, expiration (all required)

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/greeks_cell_details?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/greeks_cell_details", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/greeks_statistics
Basic greeks_heatmap

Summary statistics for one Greek on one expiration.

Parameters

ticker, expiration (required); greek (default delta); type (default calls)

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/greeks_statistics?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/greeks_statistics", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/volume_oi_heatmap
Basic greeks_heatmap

Volume or open-interest heatmap across strikes × expirations.

Parameters

ticker (required); data_type ∈ volume | open_interest; type ∈ calls | puts; max_exps (default 8)

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/volume_oi_heatmap?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/volume_oi_heatmap", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/historical_greeks
Login + Basic greeks_heatmap

Time series of a single contract's Greeks.

Parameters

ticker, expiration, strike (required); option_type (default call); lookback_days (default 90)

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/historical_greeks?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/historical_greeks", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.

Greeks exposure (/api/greeks-exposure)

Feature key: greeks_exposure (Premium). This is the active endpoint behind the GEX/exposure pages.

GET /api/greeks-exposure/<ticker>
Premium greeks_exposure

All dealer-exposure profiles in one call: GEX, DEX, theta, vega, charm, vanna, and higher-order exposures by strike, with flip points.

Parameters

expiration (optional), aggregate (default true)

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/greeks-exposure/AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/greeks-exposure/AAPL")
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.

Legacy GEX module (hidden)

Feature keys gex_analysis / third_order_greeks / charm_exposure / pin_risk are unpublished — these routes 404 for regular users. The data is available via /api/greeks-exposure and the MCP endpoints instead.

GET /api/gex
Premium gex_analysis [Hidden]

Gamma exposure by strike with flip point.

Parameters

ticker (required), expiration, aggregate (default true)

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/gex?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/gex", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/cross_index_gex
Premium gex_analysis [Hidden]

GEX comparison across major indices.

Parameters

indices (comma-separated, optional)

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/cross_index_gex"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/cross_index_gex")
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/third_order_greeks
Pro third_order_greeks [Hidden]

Speed, zomma, color, vomma, ultima.

Parameters

ticker (required), expiration

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/third_order_greeks?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/third_order_greeks", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/charm_exposure
Pro charm_exposure [Hidden]

Charm (delta-decay) exposure.

Parameters

ticker (required), expiration

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/charm_exposure?ticker=AAPL"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/charm_exposure", params={"ticker": "AAPL"})
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
GET /api/pin_risk
Pro pin_risk [Hidden — coming soon]

Pin-risk scanner. Returns 503 'coming soon' even for admins.

# log in first and reuse the cookie jar (see Authentication)
curl -b cookies.txt "https://apexvol.com/api/pin_risk"
import requests
s = requests.Session()
# log in to populate the session cookie (see Authentication)
r = s.get("https://apexvol.com/api/pin_risk")
print(r.json())
# With the apexvol-mcp server connected to Claude, just ask:
"What's the gamma exposure for SPY?"

# Claude routes the request to the matching MCP tool — no HTTP required.
← All sections MCP / Claude integration →
7 days free, cancel anytime Card required · no charge for 7 days
Start trial →