Strike Dependency API - Which Expiries Hold a SPY/QQQ Gamma Level | FlashAlpha
  1. 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

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

Parameters

Name In Type Required Default Description
symbolpathstringrequired - SPY or QQQ
strikequerynumberrequired - 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.

GET

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_usdnumberThe 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[]arrayOne 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_expirystringThe 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_pctnumber100 × (strike / spot − 1).
data_statusstringSame provenance and quality fields (reasons[], snapshot_id, timestamps) as expiry impact.
strikenumberStrike price
net_gex_usdnumberNet GEX (USD)
call_gex_usdnumberCall GEX (USD)
put_gex_usdnumberPut GEX (USD)
contract_countnumberContract count
dominant_expiry_share_pctnumberDominant expiry share (%)
symbolstringUnderlying symbol
underlying_pricenumberUnderlying price used for the calculation
snapshot_idstringSnapshot ID
generated_atstringGenerated timestamp (UTC)
quote_atstringQuote timestamp (UTC)
greeks_oldest_atstringGreeks oldest timestamp (UTC)
greeks_newest_atstringGreeks newest timestamp (UTC)
calculation_versionstringCalculation version
pricing_basisstringPricing basis
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 by_expiry[]

Field Type Description
by_expiry[].expirystringExpiration date (yyyy-MM-dd)
by_expiry[].valuation_cutoff_atstringBy expiry: valuation cutoff timestamp (UTC)
by_expiry[].last_trading_atstringBy expiry: last trading timestamp (UTC)
by_expiry[].last_trading_statusstringBy expiry: last trading status
by_expiry[].settlement_atstring | nullBy expiry: settlement timestamp (UTC)
by_expiry[].settlement_statusstringBy expiry: settlement status
by_expiry[].calendar_days_to_expirynumberBy expiry: calendar days to expiry
by_expiry[].gross_share_pctnumberBy expiry: gross share (%)
by_expiry[].share_of_strike_gross_pctnumberBy expiry: share of strike gross (%)
by_expiry[].net_gex_usdnumberBy expiry: net GEX (USD)
by_expiry[].call_gex_usdnumberBy expiry: call GEX (USD)
by_expiry[].put_gex_usdnumberBy expiry: put GEX (USD)
by_expiry[].contract_countnumberBy expiry: contract count
by_expiry[].gross_gex_usdnumberThe 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
400invalid_strikestrike 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.
403tier_restrictedYour plan is below Growth. The body includes current_plan and required_plan.
404symbol_not_found / strike_not_foundNo data for the symbol, or the exact strike has no eligible active contracts (the body echoes requested_strike).
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

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

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.

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