Earnings Strategies API

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);

API Key

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_straddle`	Suitability (0–100) for a long straddle (favored when premium is cheap / negative gamma).
`scores.short_strangle`	Suitability for a short strangle (favored when premium is rich, positive gamma, high crush).
`scores.iron_condor`	Suitability for an iron condor (defined-risk premium sale).
`scores.calendar_spread`	Suitability for a calendar spread.
`scores.earnings_diagonal`	Suitability for an earnings diagonal.
`context.premium_ratio`	VRP premium ratio (implied / realized-median) feeding the scores.
`context.iv_crush_median`	Median historical IV crush (%) feeding the scores.
`context.regime`	Gamma regime: `positive_gamma`, `negative_gamma`, or `undetermined`.
`context.implied_move_pct`	Earnings-implied move (%) used as the scoring input.

Errors

Status	Description
`403`	Caller is below the Alpha tier.
`404`	`no_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

Complementary endpoints

Earnings overview - the hub tying together every earnings endpoint
Earnings VRP - the premium ratio feeding these structure scores
Earnings IV Crush - the crush input behind premium-selling scores
Earnings Dealer Positioning - the gamma regime that gates the rankings