Expiry Impact API - SPY/QQQ Gamma Concentration Without One Expiry | FlashAlpha
  1. Expiry Impact API

Expiry Impact API

How much of SPY or QQQ gamma concentration depends on one expiry? Compare the captured chain with and without that expiry: gross share removed, net GEX change, sign change and the strikes that lose the most gamma.

Endpoint

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

Parameters

Name In Type Required Default Description
symbolpathstringrequired - SPY or QQQ
expiryquerydatenearest active expiryyyyy-MM-dd; must be one of available_expiries. Invalid values return 400 invalid_expiry.
limitqueryinteger51-20 ranked strike rows; totals always use the full eligible chain. Invalid values return 400 invalid_limit. Non-numeric values return a 400 problem-details body.

Request

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/exposure/expiry-impact/SPY?limit=5"
import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/exposure/expiry-impact/SPY",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    params={"limit": 5}
)
resp.raise_for_status()
data = resp.json()
impact = data["impact"]
print(f"{data['selected_expiry']} holds {impact['removed_gross_share_pct']:.1f}% of gross gamma")
print(f"net sign: {impact['net_sign_before']} before, {impact['net_sign_after']} after")
const resp = await fetch(
  "https://lab.flashalpha.com/v1/exposure/expiry-impact/SPY?limit=5",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
console.log(data.selected_expiry + " holds " + data.impact.removed_gross_share_pct.toFixed(1) + "% of gross gamma");

Try it live

Runs on live market data and uses 1 request from your daily quota.

GET

Response

{
  "selected_expiry": "2026-10-30",
  "selection_source": "nearest_active",
  "available_expiries": [
    "2026-10-30",
    "2026-11-02",
    "2026-11-03"
  ],
  "current": {
    "gross_gex_usd": 45016896338,
    "net_gex_usd": -15515485906,
    "call_gex_usd": 14750705216,
    "put_gex_usd": -30266191122,
    "contract_count": 11359
  },
  "excluded_expiry": {
    "gross_gex_usd": 12623235250,
    "net_gex_usd": -6897558061,
    "call_gex_usd": 2862838595,
    "put_gex_usd": -9760396656,
    "contract_count": 202
  },
  "excluding_expiry": {
    "gross_gex_usd": 32393661088,
    "net_gex_usd": -8617927844,
    "call_gex_usd": 11887866622,
    "put_gex_usd": -20505794466,
    "contract_count": 11157,
    "status": "available"
  },
  "impact": {
    "removed_gross_share_pct": 28.0411,
    "retained_gross_share_pct": 71.9589,
    "net_gex_change_usd": 6897558061,
    "net_sign_before": "negative",
    "net_sign_after": "negative",
    "net_sign_changed": false,
    "largest_gross_reductions": [
      {
        "strike": 760,
        "distance_from_spot_pct": -0.052604,
        "current_gross_gex_usd": 3722847523,
        "current_net_gex_usd": -2453681847,
        "excluded_gross_gex_usd": 2115341192,
        "excluded_net_gex_usd": -1533592991,
        "remaining_gross_gex_usd": 1607506332,
        "remaining_net_gex_usd": -920088856,
        "excluded_share_at_strike_pct": 56.8205
      },
      {
        "strike": 765,
        "distance_from_spot_pct": 0.604945,
        "current_gross_gex_usd": 3096846576,
        "current_net_gex_usd": -1959308189,
        "excluded_gross_gex_usd": 1970029531,
        "excluded_net_gex_usd": -1550763563,
        "remaining_gross_gex_usd": 1126817045,
        "remaining_net_gex_usd": -408544626,
        "excluded_share_at_strike_pct": 63.6141
      }
    ],
    "strongest_remaining_concentrations": [
      {
        "strike": 750,
        "distance_from_spot_pct": -1.3677,
        "current_gross_gex_usd": 2921692063,
        "current_net_gex_usd": -2169887090,
        "excluded_gross_gex_usd": 632305495,
        "excluded_net_gex_usd": -546808628,
        "remaining_gross_gex_usd": 2289386569,
        "remaining_net_gex_usd": -1623078462,
        "excluded_share_at_strike_pct": 21.6418
      },
      {
        "strike": 760,
        "distance_from_spot_pct": -0.052604,
        "current_gross_gex_usd": 3722847523,
        "current_net_gex_usd": -2453681847,
        "excluded_gross_gex_usd": 2115341192,
        "excluded_net_gex_usd": -1533592991,
        "remaining_gross_gex_usd": 1607506332,
        "remaining_net_gex_usd": -920088856,
        "excluded_share_at_strike_pct": 56.8205
      }
    ]
  },
  "strikes": [
    {
      "strike": 50,
      "distance_from_spot_pct": -93.4245,
      "current_gross_gex_usd": 7648.96,
      "current_net_gex_usd": -6758.09,
      "excluded_gross_gex_usd": 0,
      "excluded_net_gex_usd": 0,
      "remaining_gross_gex_usd": 7648.96,
      "remaining_net_gex_usd": -6758.09,
      "excluded_share_at_strike_pct": 0
    },
    {
      "strike": 55,
      "distance_from_spot_pct": -92.767,
      "current_gross_gex_usd": 170.4206,
      "current_net_gex_usd": -133.583,
      "excluded_gross_gex_usd": 0,
      "excluded_net_gex_usd": 0,
      "remaining_gross_gex_usd": 170.4206,
      "remaining_net_gex_usd": -133.583,
      "excluded_share_at_strike_pct": 0
    }
  ],
  "facts": [
    {
      "code": "expiry_gross_share",
      "text": "The selected expiry contributes 28.0% of captured gross gamma exposure.",
      "supporting_values": {
        "expiry": "2026-10-30",
        "gross_share_pct": 28.0411,
        "gross_gex_usd": 12623235250
      }
    },
    {
      "code": "fixed_input_comparison",
      "text": "The comparison removes contracts while holding spot, gamma and open interest fixed; it is not a forecast of post-expiry prices.",
      "supporting_values": {
        "underlying_price": 760.4,
        "remaining_contract_count": 11157
      }
    }
  ],
  "symbol": "SPY",
  "underlying_price": 760.4,
  "snapshot_id": "51c4c80d32e6125aa0ade5c1e94701e90b77ee9caccd5b483c8a18cce89d2ddc",
  "generated_at": "2026-10-30T13:45:38.7108246Z",
  "quote_at": "2026-10-30T13:45:38.395Z",
  "greeks_oldest_at": "2026-10-30T13:42:31Z",
  "greeks_newest_at": "2026-10-30T13:45:35Z",
  "calculation_version": "gamma-context-v2",
  "pricing_basis": "captured_cached_gamma_current_spot",
  "data_status": "partial",
  "reasons": [
    {
      "code": "expiry_clock_unverified",
      "message": "Excluded 302 contract(s): expiry_clock_unverified.",
      "contract_count": 302
    },
    {
      "code": "gamma_unavailable",
      "message": "Excluded 657 contract(s): gamma_unavailable.",
      "contract_count": 657
    }
  ],
  "oi_as_of": null,
  "oi_vintage_status": "unknown",
  "eligible_contract_count": 11359,
  "rejected_contract_count": 959,
  "observed_min_strike": 50,
  "observed_max_strike": 1480,
  "gex_unit": "usd_delta_notional_per_1pct_move",
  "sign_convention": "calls_positive_puts_negative",
  "analysis_type": "expiry_removal_sensitivity",
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa5",
    "equity_feed": "2026-10-30T13:45:38.627Z",
    "equity_options_feed": "2026-10-30T13:45:38Z",
    "index_feed": "2026-10-30T13:45:38.099Z",
    "index_options_feed": "2026-10-30T13:45:37Z",
    "futures_feed": "2026-10-30T13:45:28.31Z",
    "futures_options_feed": "2026-10-30T13:45:27.486Z",
    "flow_feed": "2026-10-30T13:45:00Z",
    "oi_feed": "2026-10-29T20:00:00Z",
    "macro_feed": "2026-10-29T21:00:20Z"
  }
}

Sending request…

See this endpoint on live data

Send this exact request and the real response shows up here, right next to the example.

Real response from the live API (2026-10-20 15:00 UTC), with lists shortened to three items. Download the full response (JSON).

Responses can exceed 170 KB; narrow with expiry.

Response Fields

Field Type Description
currentobjectThe whole eligible chain: gross_gex_usd, net_gex_usd, call_gex_usd, put_gex_usd (USD per 1% move) and contract_count.
excluded_expiryobjectThe same totals for the selected expiry only.
excluding_expiryobjectThe same totals for the chain without it, plus status: available, zero_gross_exposure or no_remaining_contracts.
impactobjectremoved_gross_share_pct = 100 × excluded gross / current gross (null when current gross is zero), retained_gross_share_pct, net_gex_change_usd (remaining net minus current net), net_sign_before / net_sign_after / net_sign_changed, and the top limit strikes in largest_gross_reductions and strongest_remaining_concentrations.
strikes[]arrayEvery eligible strike with current, excluded and remaining gross/net GEX and distance from spot.
facts[]arrayPlain-language statements with their supporting values.
pricing_basisstringcaptured_cached_gamma_current_spot (SPY: cached Greeks at current spot) or qqq_common_anchor_repriced (QQQ: raw quotes repriced at one spot and time).
data_statusstringpartial in normal operation (open-interest vintage is unknown), stale when an input predates the session freshness cutoff, unavailable when no contract qualifies. reasons[] carry machine codes and excluded-contract counts.
snapshot_idstringSHA-256 fingerprint of the captured inputs; identical inputs give identical IDs.
selected_expirystringSelected expiry
selection_sourcestringSelection source
available_expiriesarray of stringAvailable expiries
current.gross_gex_usdnumberCurrent: gross GEX (USD)
current.net_gex_usdnumberCurrent: net GEX (USD)
current.call_gex_usdnumberCurrent: call GEX (USD)
current.put_gex_usdnumberCurrent: put GEX (USD)
current.contract_countnumberCurrent: contract count
excluded_expiry.gross_gex_usdnumberExcluded expiry: gross GEX (USD)
excluded_expiry.net_gex_usdnumberExcluded expiry: net GEX (USD)
excluded_expiry.call_gex_usdnumberExcluded expiry: call GEX (USD)
excluded_expiry.put_gex_usdnumberExcluded expiry: put GEX (USD)
excluded_expiry.contract_countnumberExcluded expiry: contract count
excluding_expiry.gross_gex_usdnumberExcluding expiry: gross GEX (USD)
excluding_expiry.net_gex_usdnumberExcluding expiry: net GEX (USD)
excluding_expiry.call_gex_usdnumberExcluding expiry: call GEX (USD)
excluding_expiry.put_gex_usdnumberExcluding expiry: put GEX (USD)
excluding_expiry.contract_countnumberExcluding expiry: contract count
excluding_expiry.statusstringExcluding expiry: status
facts[].codestringFacts: code
facts[].textstringFacts: text
facts[].supporting_valuesobjectFacts: supporting values
facts[].supporting_values.expirystringExpiration date (yyyy-MM-dd)
facts[].supporting_values.gross_share_pctnumberSupporting values: gross share (%)
facts[].supporting_values.gross_gex_usdnumberSupporting values: gross GEX (USD)
facts[].supporting_values.underlying_pricenumberUnderlying price used for the calculation
facts[].supporting_values.remaining_contract_countnumberSupporting values: remaining contract count
symbolstringUnderlying symbol
underlying_pricenumberUnderlying price used for the calculation
generated_atstringGenerated timestamp (UTC)
quote_atstringQuote timestamp (UTC)
greeks_oldest_atstringGreeks oldest timestamp (UTC)
greeks_newest_atstringGreeks newest timestamp (UTC)
calculation_versionstringCalculation version
reasonsarrayReasons
reasons[].codestringReasons: code
reasons[].messagestringHuman-readable message
reasons[].contract_countnumber | nullReasons: contract count
oi_as_ofstring | nullOI as of
oi_vintage_statusstringOI vintage status
eligible_contract_countnumberEligible contract count
rejected_contract_countnumberRejected contract count
observed_min_strikenumberObserved min strike
observed_max_strikenumberObserved max strike
gex_unitstringGEX unit
sign_conventionstringSign convention
analysis_typestringAnalysis type
endpoint_version, data_as_ofstring, objectResponse envelope, see Response envelope.

Fields of impact

Field Type Description
impact.removed_gross_share_pctnumber100 × excluded gross / current gross. Null when current gross is zero.
impact.retained_gross_share_pctnumberImpact: retained gross share (%)
impact.net_gex_change_usdnumberremaining net − current net (minus the excluded net).
impact.net_sign_beforestringImpact: net sign before
impact.net_sign_afterstringImpact: net sign after
impact.net_sign_changedbooleanImpact: net sign changed
impact.largest_gross_reductionsarrayImpact: largest gross reductions
impact.largest_gross_reductions[].strikenumberStrike price
impact.largest_gross_reductions[].distance_from_spot_pctnumberLargest gross reductions: distance from spot (%)
impact.largest_gross_reductions[].current_gross_gex_usdnumberLargest gross reductions: current gross GEX (USD)
impact.largest_gross_reductions[].current_net_gex_usdnumberLargest gross reductions: current net GEX (USD)
impact.largest_gross_reductions[].excluded_gross_gex_usdnumberLargest gross reductions: excluded gross GEX (USD)
impact.largest_gross_reductions[].excluded_net_gex_usdnumberLargest gross reductions: excluded net GEX (USD)
impact.largest_gross_reductions[].remaining_gross_gex_usdnumberLargest gross reductions: remaining gross GEX (USD)
impact.largest_gross_reductions[].remaining_net_gex_usdnumberLargest gross reductions: remaining net GEX (USD)
impact.largest_gross_reductions[].excluded_share_at_strike_pctnumberLargest gross reductions: excluded share at strike (%)
impact.strongest_remaining_concentrationsarrayImpact: strongest remaining concentrations
impact.strongest_remaining_concentrations[].strikenumberStrike price
impact.strongest_remaining_concentrations[].distance_from_spot_pctnumberStrongest remaining concentrations: distance from spot (%)
impact.strongest_remaining_concentrations[].current_gross_gex_usdnumberStrongest remaining concentrations: current gross GEX (USD)
impact.strongest_remaining_concentrations[].current_net_gex_usdnumberStrongest remaining concentrations: current net GEX (USD)
impact.strongest_remaining_concentrations[].excluded_gross_gex_usdnumberStrongest remaining concentrations: excluded gross GEX (USD)
impact.strongest_remaining_concentrations[].excluded_net_gex_usdnumberStrongest remaining concentrations: excluded net GEX (USD)
impact.strongest_remaining_concentrations[].remaining_gross_gex_usdnumberStrongest remaining concentrations: remaining gross GEX (USD)
impact.strongest_remaining_concentrations[].remaining_net_gex_usdnumberStrongest remaining concentrations: remaining net GEX (USD)
impact.strongest_remaining_concentrations[].excluded_share_at_strike_pctnumberStrongest remaining concentrations: excluded share at strike (%)

Fields of strikes[]

Field Type Description
strikes[].strikenumberStrike price
strikes[].distance_from_spot_pctnumberStrikes: distance from spot (%)
strikes[].current_gross_gex_usdnumberStrikes: current gross GEX (USD)
strikes[].current_net_gex_usdnumberStrikes: current net GEX (USD)
strikes[].excluded_gross_gex_usdnumberStrikes: excluded gross GEX (USD)
strikes[].excluded_net_gex_usdnumberStrikes: excluded net GEX (USD)
strikes[].remaining_gross_gex_usdnumberStrikes: remaining gross GEX (USD)
strikes[].remaining_net_gex_usdnumberStrikes: remaining net GEX (USD)
strikes[].excluded_share_at_strike_pctnumberStrikes: excluded share at strike (%)

Errors

Status Error When
400invalid_expiryexpiry is not yyyy-MM-dd.
400invalid_limitlimit is outside 1-20.
400-A query value has the wrong type, or a required value is missing. The body is an RFC 7807 problem-details object with errors.<param>.
401-Missing or invalid X-Api-Key. The body is empty; check the status code before parsing JSON.
403tier_restrictedYour plan is below Growth. The body includes current_plan and required_plan.
404symbol_not_found / expiry_not_found / no_eligible_contractsNo data for the symbol; no eligible contracts for the requested expiry (the body lists available_expiries); or no eligible contracts at all.
422unsupported_symbolOnly SPY and QQQ are supported.
429Quota exceededDaily quota used up. Retry-After gives the seconds until the reset at 00:00 UTC. Rejected requests (including 403) count toward the quota.
503invalid_spotNo finite positive underlying price.

About

Expiry impact answers a narrow question: how much of the current SPY or QQQ gamma concentration sits in one expiry? It sums contract-level gamma exposure (gamma × OI × 100 × spot² × 0.01, calls positive and puts negative) for one captured chain, then recomputes the same totals without the selected expiry. Spot, Greeks and open interest are held fixed, so the difference is a sensitivity of today's distribution, not a forecast of the next session's chain or of dealer hedging after expiry.

Gross exposure sums magnitudes, so an expiry can remove a large share of gross gamma while barely moving net. Shares use gross; the net change and sign show what the convention-signed total does. The sign is a convention, not observed dealer inventory. SPY uses stored Greeks at the current spot; QQQ reprices raw quotes at one anchor, as QQQ GEX does. An expiring contract leaves the model at 16:00 ET and early-close expiries are excluded until their clocks are verified.

Every response carries a snapshot_id fingerprint of its inputs, quote and Greek timestamps, rejected-contract counts and data_status. The source does not record when open interest was published, so oi_as_of is null and the status is partial in normal operation.

Replay the same view at a past minute on historical.flashalpha.com with at= (Alpha). Date-only at resolves to 15:55 ET so same-day Greeks stay defined. See historical trader context.

Common Use Cases

  • Size the 0DTE share - how much of today's gross gamma rolls off at the close
  • Check OPEX roll-off - compare the monthly expiry's share during OPEX week with an ordinary week
  • Find strikes that depend on one expiry - largest_gross_reductions ranks the strikes losing the most gross gamma
  • See whether the modeled net sign flips - net_sign_changed shows whether removing the expiry flips the convention-signed total
  • Pair with strike dependency - drill into one wall to see which expiries hold it

Research

This endpoint was replayed at the close of every 2022-2025 SPY and QQQ session. Sessions where the expiring expiry held the largest gross share were followed by calmer next sessions, not wilder ones.

Related reading

Complementary endpoints

Ready to build with FlashAlpha?

Get your free API key and start pulling live options data in 60 seconds.

No credit card required Setup in 60 seconds Secure & reliable