Exposure Summary API - Aggregate GEX DEX VEX CHEX - FlashAlpha Lab API
Lab API Exposure Summary

Exposure Summary API

Get aggregate GEX, DEX, VEX, and CHEX with regime classification, interpretations, and hedging estimates in a single call.

What Is the Exposure Summary?

The Summary endpoint returns a complete options exposure overview in a single API call. Instead of querying GEX, DEX, VEX, and CHEX separately, you get all four aggregate values plus the current gamma regime (positive, negative, or undetermined), plain-English interpretations for each metric, dealer hedging estimates for ±1% spot moves, and the percentage contributed by same-day (0DTE) options. This is the most efficient endpoint for building dashboards or monitoring tools.

Common Use Cases

  • One-call dashboards — populate an entire exposure panel with a single API request instead of four
  • Regime monitoring — instantly know whether the market is in a positive or negative gamma regime
  • Hedging impact estimation — see how much buying or selling dealers would do on a 1% move
  • Alert systems — trigger alerts when regime changes or exposure crosses thresholds
  • 0DTE impact tracking — monitor how much of total exposure comes from same-day expirations

When to Use This Endpoint

Use the Summary endpoint when you need the big picture without strike-level detail. For per-strike breakdowns, use the individual GEX, DEX, VEX, or CHEX endpoints. Summary is ideal for dashboards, alerts, and any workflow where you need all four metrics in one call.

Endpoint

GET /v1/exposure/summary/{symbol}
Auth required (X-Api-Key) Rate Limited: Yes Growth plan+

Parameters

Name In Required Default Description
symbol path yes Underlying symbol
curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/exposure/summary/SPY"
import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/exposure/summary/SPY",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
data = resp.json()
print(f"Regime: {data['regime']}")
print(f"Net GEX: ${data['exposures']['net_gex']:,.0f}")
const resp = await fetch(
  "https://lab.flashalpha.com/v1/exposure/summary/SPY",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
const data = await resp.json();
console.log(`Regime: ${data.regime}`);
console.log(`Net GEX: $${data.exposures.net_gex.toLocaleString()}`);

Response

{
  "symbol": "SPY",
  "underlying_price": 597.505,
  "as_of": "2026-02-28T16:30:45Z",
  "gamma_flip": 595.25,
  "regime": "positive_gamma",
  "exposures": {
    "net_gex": 2850000000,
    "net_dex": -450000000,
    "net_vex": 1200000000,
    "net_chex": 850000000
  },
  "interpretation": {
    "gamma": "Dealers long gamma — expect range-bound, mean-reverting price action",
    "vanna": "Positive vanna — benefits from vol compression",
    "charm": "Time decay favors dealers — supports decline into close"
  },
  "hedging_estimate": {
    "spot_down_1pct": { "dealer_shares_to_trade": 4780000, "direction": "BUY", "notional_usd": 2852000000 },
    "spot_up_1pct": { "dealer_shares_to_trade": -4780000, "direction": "SELL", "notional_usd": 2852000000 }
  },
  "zero_dte": { "net_gex": 285000000, "pct_of_total_gex": 10.0, "expiration": "2026-02-28" }
}

Key Response Fields

Field Type Description
symbolstringUnderlying symbol
underlying_pricenumberCurrent price of underlying
as_ofstringISO 8601 timestamp
gamma_flipnumberStrike where net GEX crosses zero
regimestringGamma regime: positive_gamma, negative_gamma, or undetermined
exposuresobjectAggregate exposure values for all four metrics
interpretationobjectPlain-English interpretations for gamma, vanna, and charm
hedging_estimateobjectEstimated dealer hedging for ±1% spot moves, including share count, direction, and notional USD
zero_dteobjectSame-day (0DTE) exposure breakdown: net GEX, percentage of total, and expiration date
FlashAlpha
© FlashAlpha. All rights reserved.