- Live API Reference
- Exposure Analytics
- 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
X-Api-Key)
Rate Limited: Yes
Plan: Growth+
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
symbol | path | string | required | - | SPY or QQQ |
expiry | query | date | nearest active expiry | yyyy-MM-dd; must be one of available_expiries. Invalid values return 400 invalid_expiry. | |
limit | query | integer | 5 | 1-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.
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 |
|---|---|---|
current | object | The whole eligible chain: gross_gex_usd, net_gex_usd, call_gex_usd, put_gex_usd (USD per 1% move) and contract_count. |
excluded_expiry | object | The same totals for the selected expiry only. |
excluding_expiry | object | The same totals for the chain without it, plus status: available, zero_gross_exposure or no_remaining_contracts. |
impact | object | removed_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[] | array | Every eligible strike with current, excluded and remaining gross/net GEX and distance from spot. |
facts[] | array | Plain-language statements with their supporting values. |
pricing_basis | string | captured_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_status | string | partial 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_id | string | SHA-256 fingerprint of the captured inputs; identical inputs give identical IDs. |
selected_expiry | string | Selected expiry |
selection_source | string | Selection source |
available_expiries | array of string | Available expiries |
current.gross_gex_usd | number | Current: gross GEX (USD) |
current.net_gex_usd | number | Current: net GEX (USD) |
current.call_gex_usd | number | Current: call GEX (USD) |
current.put_gex_usd | number | Current: put GEX (USD) |
current.contract_count | number | Current: contract count |
excluded_expiry.gross_gex_usd | number | Excluded expiry: gross GEX (USD) |
excluded_expiry.net_gex_usd | number | Excluded expiry: net GEX (USD) |
excluded_expiry.call_gex_usd | number | Excluded expiry: call GEX (USD) |
excluded_expiry.put_gex_usd | number | Excluded expiry: put GEX (USD) |
excluded_expiry.contract_count | number | Excluded expiry: contract count |
excluding_expiry.gross_gex_usd | number | Excluding expiry: gross GEX (USD) |
excluding_expiry.net_gex_usd | number | Excluding expiry: net GEX (USD) |
excluding_expiry.call_gex_usd | number | Excluding expiry: call GEX (USD) |
excluding_expiry.put_gex_usd | number | Excluding expiry: put GEX (USD) |
excluding_expiry.contract_count | number | Excluding expiry: contract count |
excluding_expiry.status | string | Excluding expiry: status |
facts[].code | string | Facts: code |
facts[].text | string | Facts: text |
facts[].supporting_values | object | Facts: supporting values |
facts[].supporting_values.expiry | string | Expiration date (yyyy-MM-dd) |
facts[].supporting_values.gross_share_pct | number | Supporting values: gross share (%) |
facts[].supporting_values.gross_gex_usd | number | Supporting values: gross GEX (USD) |
facts[].supporting_values.underlying_price | number | Underlying price used for the calculation |
facts[].supporting_values.remaining_contract_count | number | Supporting values: remaining contract count |
symbol | string | Underlying symbol |
underlying_price | number | Underlying price used for the calculation |
generated_at | string | Generated timestamp (UTC) |
quote_at | string | Quote timestamp (UTC) |
greeks_oldest_at | string | Greeks oldest timestamp (UTC) |
greeks_newest_at | string | Greeks newest timestamp (UTC) |
calculation_version | string | Calculation version |
reasons | array | Reasons |
reasons[].code | string | Reasons: code |
reasons[].message | string | Human-readable message |
reasons[].contract_count | number | null | Reasons: contract count |
oi_as_of | string | null | OI as of |
oi_vintage_status | string | OI vintage status |
eligible_contract_count | number | Eligible contract count |
rejected_contract_count | number | Rejected contract count |
observed_min_strike | number | Observed min strike |
observed_max_strike | number | Observed max strike |
gex_unit | string | GEX unit |
sign_convention | string | Sign convention |
analysis_type | string | Analysis type |
endpoint_version, data_as_of | string, object | Response envelope, see Response envelope. |
Fields of impact
| Field | Type | Description |
|---|---|---|
impact.removed_gross_share_pct | number | 100 × excluded gross / current gross. Null when current gross is zero. |
impact.retained_gross_share_pct | number | Impact: retained gross share (%) |
impact.net_gex_change_usd | number | remaining net − current net (minus the excluded net). |
impact.net_sign_before | string | Impact: net sign before |
impact.net_sign_after | string | Impact: net sign after |
impact.net_sign_changed | boolean | Impact: net sign changed |
impact.largest_gross_reductions | array | Impact: largest gross reductions |
impact.largest_gross_reductions[].strike | number | Strike price |
impact.largest_gross_reductions[].distance_from_spot_pct | number | Largest gross reductions: distance from spot (%) |
impact.largest_gross_reductions[].current_gross_gex_usd | number | Largest gross reductions: current gross GEX (USD) |
impact.largest_gross_reductions[].current_net_gex_usd | number | Largest gross reductions: current net GEX (USD) |
impact.largest_gross_reductions[].excluded_gross_gex_usd | number | Largest gross reductions: excluded gross GEX (USD) |
impact.largest_gross_reductions[].excluded_net_gex_usd | number | Largest gross reductions: excluded net GEX (USD) |
impact.largest_gross_reductions[].remaining_gross_gex_usd | number | Largest gross reductions: remaining gross GEX (USD) |
impact.largest_gross_reductions[].remaining_net_gex_usd | number | Largest gross reductions: remaining net GEX (USD) |
impact.largest_gross_reductions[].excluded_share_at_strike_pct | number | Largest gross reductions: excluded share at strike (%) |
impact.strongest_remaining_concentrations | array | Impact: strongest remaining concentrations |
impact.strongest_remaining_concentrations[].strike | number | Strike price |
impact.strongest_remaining_concentrations[].distance_from_spot_pct | number | Strongest remaining concentrations: distance from spot (%) |
impact.strongest_remaining_concentrations[].current_gross_gex_usd | number | Strongest remaining concentrations: current gross GEX (USD) |
impact.strongest_remaining_concentrations[].current_net_gex_usd | number | Strongest remaining concentrations: current net GEX (USD) |
impact.strongest_remaining_concentrations[].excluded_gross_gex_usd | number | Strongest remaining concentrations: excluded gross GEX (USD) |
impact.strongest_remaining_concentrations[].excluded_net_gex_usd | number | Strongest remaining concentrations: excluded net GEX (USD) |
impact.strongest_remaining_concentrations[].remaining_gross_gex_usd | number | Strongest remaining concentrations: remaining gross GEX (USD) |
impact.strongest_remaining_concentrations[].remaining_net_gex_usd | number | Strongest remaining concentrations: remaining net GEX (USD) |
impact.strongest_remaining_concentrations[].excluded_share_at_strike_pct | number | Strongest remaining concentrations: excluded share at strike (%) |
Fields of strikes[]
| Field | Type | Description |
|---|---|---|
strikes[].strike | number | Strike price |
strikes[].distance_from_spot_pct | number | Strikes: distance from spot (%) |
strikes[].current_gross_gex_usd | number | Strikes: current gross GEX (USD) |
strikes[].current_net_gex_usd | number | Strikes: current net GEX (USD) |
strikes[].excluded_gross_gex_usd | number | Strikes: excluded gross GEX (USD) |
strikes[].excluded_net_gex_usd | number | Strikes: excluded net GEX (USD) |
strikes[].remaining_gross_gex_usd | number | Strikes: remaining gross GEX (USD) |
strikes[].remaining_net_gex_usd | number | Strikes: remaining net GEX (USD) |
strikes[].excluded_share_at_strike_pct | number | Strikes: excluded share at strike (%) |
Errors
| Status | Error | When |
|---|---|---|
400 | invalid_expiry | expiry is not yyyy-MM-dd. |
400 | invalid_limit | limit 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. |
403 | tier_restricted | Your plan is below Growth. The body includes current_plan and required_plan. |
404 | symbol_not_found / expiry_not_found / no_eligible_contracts | No data for the symbol; no eligible contracts for the requested expiry (the body lists available_expiries); or no eligible contracts at all. |
422 | unsupported_symbol | Only SPY and QQQ are supported. |
429 | Quota exceeded | Daily quota used up. Retry-After gives the seconds until the reset at 00:00 UTC. Rejected requests (including 403) count toward the quota. |
503 | invalid_spot | No 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_reductionsranks the strikes losing the most gross gamma - See whether the modeled net sign flips -
net_sign_changedshows whether removing the expiry flips the convention-signed total - Pair with strike dependency - drill into one wall to see which expiries hold it
Related
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.
- Does expiring gamma move the market? - results and method
- Research pack
trader-context-spy-qqq-2022-2025-v2-34105d743fac- data, audit and reproduction (Alpha)
Related reading
- 0DTE gamma exposure and pin risk - why same-day expiries dominate intraday gamma
- Call wall, put wall and gamma flip explained - the levels whose expiry mix this endpoint decomposes
Complementary endpoints
- Strike Dependency - one exact strike's gamma attributed to its expiries
- Term Structure - the same gross shares per expiry in
gamma_concentration - Gamma Exposure (GEX) - strike-level GEX, gamma flip and walls
Unlock DEX, VEX and CHEX with Basic
Everything in Free, plus:
- DEX, VEX and CHEX exposure
- Full max pain
- ETF & index symbols SPY, QQQ, SPX, VIX
Go full-chain with Growth
Everything in Basic, plus:
- Full-chain GEX Every expiration
- 0DTE analytics
- Exposure summary & AI narrative
- CME futures & live screener
Add history and vol surfaces with Alpha
Everything in Growth, plus:
- Historical API replay Since 2017
- SVI vol surfaces
- VRP analytics
- Greeks surfaces Vanna, charm, volga and speed grids