Earnings Strategies API - Event Structure Suitability Scores - FlashAlpha Lab API
FlashAlpha FlashAlpha
Lab API Earnings Strategies

Earnings Strategies API

Strategy-suitability scores (0-100) for the upcoming event across common earnings structures, blending implied move, VRP premium ratio, expected IV crush, ATM liquidity, and the gamma regime.

Endpoint

GET /v1/earnings/strategies/{symbol}
Auth required (X-Api-Key) Rate Limited: Yes Alpha plan+

Parameters

Name In Required Default Description
symbol path yes - Underlying symbol (case-insensitive). 
curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/earnings/strategies/AAPL"
import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/earnings/strategies/AAPL",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
data = resp.json()
print(f"Short strangle score: {data['scores']['short_strangle']}")
const resp = await fetch(
  "https://lab.flashalpha.com/v1/earnings/strategies/AAPL",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
const data = await resp.json();
console.log("Short strangle score: " + data.scores.short_strangle);

Response

{
  "symbol": "AAPL",
  "as_of": "2026-06-05T15:42:10Z",
  "earnings_date": "2026-06-09",
  "scores": {
    "long_straddle": 38,
    "short_strangle": 72,
    "iron_condor": 65,
    "calendar_spread": 58,
    "earnings_diagonal": 61
  },
  "context": {
    "premium_ratio": 1.48,
    "iv_crush_median": 38.5,
    "regime": "negative_gamma",
    "implied_move_pct": 4.6
  }
}

Key Response Fields

Field Description
scores.long_straddleSuitability (0-100) for a long straddle (favored when premium is cheap / negative gamma).
scores.short_strangleSuitability for a short strangle (favored when premium is rich, positive gamma, high crush).
scores.iron_condorSuitability for an iron condor (defined-risk premium sale).
scores.calendar_spreadSuitability for a calendar spread.
scores.earnings_diagonalSuitability for an earnings diagonal.
context.premium_ratioVRP premium ratio (implied / realized-median) feeding the scores.
context.iv_crush_medianMedian historical IV crush (%) feeding the scores.
context.regimeGamma regime: positive_gamma, negative_gamma, or unknown (direction undetermined: flip absent, unverified, or stressed sign uncertain near the certified level).
context.implied_move_pctEarnings-implied move (%) used as the scoring input.

Errors

Status Description
403Caller is below the Alpha tier.
404no_data - no upcoming earnings for the symbol; or symbol_not_found - no live market data.

About

Earnings Strategies ranks common event structures by suitability for the upcoming print, scoring each from 0 to 100. The scores blend the implied move, the VRP premium ratio, the expected IV crush, ATM liquidity, and the gamma regime into a single comparable number per structure.

The context block exposes the key inputs behind the scores so you can see why a structure ranked high or low. Premium-selling structures favor rich premium and high crush; premium-buying structures favor cheap premium and negative gamma.

Common Use Cases

  • Pick the best-fitting structure for an event from a single ranked scores set instead of eyeballing the chain
  • Filter to premium-selling events via high short_strangle / iron_condor scores when premium is rich and crush is high
  • Find long-volatility setups via a high long_straddle score where the implied move looks cheap
  • Surface time-spread candidates from calendar_spread / earnings_diagonal scores driven by the term kink
  • Audit any recommendation against its context inputs (premium_ratio, iv_crush_median, regime) before trading
  • Gate selection on the regime flag so premium-selling structures are skipped when dealers are negative gamma

Related reading

Complementary endpoints

Ready to build with FlashAlpha?

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

No credit card required Setup in 60 seconds Secure & reliable
Get Free API Key Try Playground