- Live API Reference
- Exposure Analytics
- Strike Dependency API
Strike Dependency API
Does a gamma level depend on one maturity? Break one exact SPY or QQQ strike's gross and net gamma into its expiries and see the dominant expiry's share.
Endpoint
X-Api-Key)
Rate Limited: Yes
Plan: Growth+
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
symbol | path | string | required | - | SPY or QQQ |
strike | query | number | required | - | Exact listed strike, positive. Never snapped to a nearby strike. Invalid values return 400 invalid_strike. |
Request
curl -H "X-Api-Key: YOUR_API_KEY" \
"https://lab.flashalpha.com/v1/exposure/strike-dependency/SPY?strike=665"import requests
resp = requests.get(
"https://lab.flashalpha.com/v1/exposure/strike-dependency/SPY",
headers={"X-Api-Key": "YOUR_API_KEY"},
params={"strike": 665}
)
resp.raise_for_status()
data = resp.json()
print(f"{data['dominant_expiry']} holds {data['dominant_expiry_share_pct']:.1f}% of the strike's gross gamma")const resp = await fetch(
"https://lab.flashalpha.com/v1/exposure/strike-dependency/SPY?strike=665",
{ headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
console.log(data.dominant_expiry + " holds " + data.dominant_expiry_share_pct.toFixed(1) + "% of the strike gross gamma");Try it live
Runs on live market data and uses 1 request from your daily quota.
Response
{
"strike": 665,
"distance_from_spot_pct": -12.5483,
"gross_gex_usd": 74874855,
"net_gex_usd": -53099140,
"call_gex_usd": 10887857,
"put_gex_usd": -63986998,
"contract_count": 49,
"by_expiry": [
{
"expiry": "2026-11-02",
"valuation_cutoff_at": "2026-11-02T21:00:00Z",
"last_trading_at": "2026-11-02T21:15:00Z",
"last_trading_status": "scheduled_regular_session",
"settlement_at": null,
"settlement_status": "unknown",
"calendar_days_to_expiry": 3,
"gross_share_pct": 0.016574,
"share_of_strike_gross_pct": 0.016574,
"gross_gex_usd": 12409.82,
"net_gex_usd": -12409.82,
"call_gex_usd": 0,
"put_gex_usd": -12409.82,
"contract_count": 1
},
{
"expiry": "2026-11-03",
"valuation_cutoff_at": "2026-11-03T21:00:00Z",
"last_trading_at": "2026-11-03T21:15:00Z",
"last_trading_status": "scheduled_regular_session",
"settlement_at": null,
"settlement_status": "unknown",
"calendar_days_to_expiry": 4,
"gross_share_pct": 2.961,
"share_of_strike_gross_pct": 2.961,
"gross_gex_usd": 2217023,
"net_gex_usd": -2217023,
"call_gex_usd": 0,
"put_gex_usd": -2217023,
"contract_count": 2
}
],
"dominant_expiry": "2026-12-18",
"dominant_expiry_share_pct": 27.7277,
"symbol": "SPY",
"underlying_price": 760.42,
"snapshot_id": "dfb7aa4b91f0d4e07c52f7430d7783e9c3091ed86812c58ae6bc9c769cc81ce1",
"generated_at": "2026-10-30T13:45:40.3619276Z",
"quote_at": "2026-10-30T13:45:39.487Z",
"greeks_oldest_at": "2026-10-30T13:42:31Z",
"greeks_newest_at": "2026-10-30T13:45:39Z",
"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 718 contract(s): gamma_unavailable.",
"contract_count": 718
}
],
"oi_as_of": null,
"oi_vintage_status": "unknown",
"eligible_contract_count": 11298,
"rejected_contract_count": 1020,
"observed_min_strike": 50,
"observed_max_strike": 1480,
"gex_unit": "usd_delta_notional_per_1pct_move",
"sign_convention": "calls_positive_puts_negative",
"analysis_type": "strike_attribution",
"endpoint_version": "2026.09.30",
"data_as_of": {
"node": "fa5",
"equity_feed": "2026-10-30T13:45:40.331Z",
"equity_options_feed": "2026-10-30T13:45:39Z",
"index_feed": "2026-10-30T13:45:39.085Z",
"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).
Response Fields
| Field | Type | Description |
|---|---|---|
gross_gex_usd | number | The strike's gross GEX across eligible expiries (USD per 1% move), with net_gex_usd, call_gex_usd, put_gex_usd and contract_count. |
by_expiry[] | array | One row per expiry at that strike: gross/net/call/put GEX, contract count, share_of_strike_gross_pct, the 16:00 ET valuation_cutoff_at and 16:15 ET last_trading_at. settlement_at stays null: neither clock proves settlement. |
dominant_expiry | string | The expiry with the largest gross share of the strike, and dominant_expiry_share_pct; null when the strike's gross is zero. |
distance_from_spot_pct | number | 100 × (strike / spot − 1). |
data_status | string | Same provenance and quality fields (reasons[], snapshot_id, timestamps) as expiry impact. |
strike | number | Strike price |
net_gex_usd | number | Net GEX (USD) |
call_gex_usd | number | Call GEX (USD) |
put_gex_usd | number | Put GEX (USD) |
contract_count | number | Contract count |
dominant_expiry_share_pct | number | Dominant expiry share (%) |
symbol | string | Underlying symbol |
underlying_price | number | Underlying price used for the calculation |
snapshot_id | string | Snapshot ID |
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 |
pricing_basis | string | Pricing basis |
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 by_expiry[]
| Field | Type | Description |
|---|---|---|
by_expiry[].expiry | string | Expiration date (yyyy-MM-dd) |
by_expiry[].valuation_cutoff_at | string | By expiry: valuation cutoff timestamp (UTC) |
by_expiry[].last_trading_at | string | By expiry: last trading timestamp (UTC) |
by_expiry[].last_trading_status | string | By expiry: last trading status |
by_expiry[].settlement_at | string | null | By expiry: settlement timestamp (UTC) |
by_expiry[].settlement_status | string | By expiry: settlement status |
by_expiry[].calendar_days_to_expiry | number | By expiry: calendar days to expiry |
by_expiry[].gross_share_pct | number | By expiry: gross share (%) |
by_expiry[].share_of_strike_gross_pct | number | By expiry: share of strike gross (%) |
by_expiry[].net_gex_usd | number | By expiry: net GEX (USD) |
by_expiry[].call_gex_usd | number | By expiry: call GEX (USD) |
by_expiry[].put_gex_usd | number | By expiry: put GEX (USD) |
by_expiry[].contract_count | number | By expiry: contract count |
by_expiry[].gross_gex_usd | number | The strike's gross GEX across eligible expiries (USD per 1% move), with net_gex_usd, call_gex_usd, put_gex_usd and contract_count. |
Errors
| Status | Error | When |
|---|---|---|
400 | invalid_strike | strike is missing, not a number, or not positive. |
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 / strike_not_found | No data for the symbol, or the exact strike has no eligible active contracts (the body echoes requested_strike). |
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
A large gamma level can live almost entirely in one expiry. If that expiry rolls off, the level can fade even though nothing about the underlying changed. Strike dependency takes one exact observed strike and breaks its gross and net gamma exposure down by expiry, using the same captured inputs, eligibility rules and units as expiry impact.
The request is never snapped to a nearby strike: an absent strike returns 404 strike_not_found. The dominant expiry share describes concentration at that strike. It is not a support or resistance probability, and the calls-positive / puts-negative sign is a convention, not observed dealer inventory.
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
- Check a wall before expiry - see whether the call or put wall is mostly 0DTE or spread across the term
- Judge how durable a level is - a level held by several expiries survives one roll-off; a single-expiry level may not
- Explain a GEX change - compare the strike's expiry mix before and after OPEX
- Pair with expiry impact - find the strikes that lose the most gamma, then attribute each one
Related
Research
Call and put walls were tested on every 2022-2025 SPY and QQQ session. Once distance to the price was matched, walls held mostly by the expiring expiry did not break reliably more often than other walls.
- 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
- Call wall, put wall and gamma flip explained - how the levels are defined
Complementary endpoints
- Expiry Impact - the chain with one expiry excluded
- Key Levels - locate the walls to attribute
- Gamma Exposure (GEX) - strike-level GEX across the chain
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