llms.txt

# FlashAlpha Java SDK

> Java client library for the FlashAlpha options analytics API. Covers
> real-time gamma / delta / vanna / charm exposure (GEX/DEX/VEX/CHEX),
> 0DTE analytics, max pain, the live options screener, the volatility
> surface, Black-Scholes greeks (1st / 2nd / 3rd order), implied
> volatility, Kelly position sizing, the variance risk premium (VRP),
> verbal narrative summaries, and live stock + option quotes — from a
> single dependency-light Java 11+ package.

## What FlashAlpha is

FlashAlpha (https://flashalpha.com) is an options dealer-flow analytics
platform. The API computes the same dealer Greek exposures, key levels,
and 0DTE pin metrics that institutional desks watch — exposed as a flat
REST API at `https://api.flashalpha.com`. The interactive Swagger
playground lives at https://lab.flashalpha.com/swagger.

## What this SDK provides

- `FlashAlphaClient` — thin HTTP wrapper around the live REST API.
  Methods return `com.google.gson.JsonObject` so callers can navigate
  the response shape with no extra deserialization step.
- Strongly-typed response POCOs for the highest-ROI endpoints —
  `ExposureSummaryResponse`, `ZeroDteResponse`, `MaxPainResponse`,
  `VrpResponse`, `StockSummaryResponse`, `NarrativeResponse`,
  `ExposureLevelsResponse`, `PricingGreeksResponse`.
- Typed exception hierarchy — `AuthenticationException`,
  `TierRestrictedException`, `NotFoundException`, `RateLimitException`,
  `ServerException`, `FlashAlphaException`.

## Key endpoints

- `GET /v1/exposure/summary/{symbol}` — full GEX/DEX/VEX/CHEX, gamma
  flip, regime, hedging estimate, 0DTE share. (Growth+)
- `GET /v1/exposure/levels/{symbol}` — minimal key-levels view.
- `GET /v1/exposure/zero-dte/{symbol}` — same-day-expiration deep dive
  (pin risk, hedging buckets, decay, vol context, flow, levels). (Growth+)
- `GET /v1/exposure/narrative/{symbol}` — LLM-friendly verbal output.
  (Growth+)
- `GET /v1/maxpain/{symbol}` — max-pain strike, pain curve, dealer
  alignment, pin probability. (Growth+)
- `GET /v1/vrp/{symbol}` — variance risk premium with regime
  conditioning and strategy scores. (Alpha+)
- `GET /v1/stock/{symbol}/summary` — one-shot dashboard (price + vol +
  flow + exposure + macro). Authenticated = live; unauthenticated =
  previous-day cached snapshot.
- `GET /v1/pricing/greeks` — Black-Scholes theoretical + 1st/2nd/3rd
  order greeks + lambda + veta.
- `POST /v1/screener` — live options screener (filter/rank symbols by
  GEX, VRP, IV, greeks, harvest scores, custom formulas).
- **Flow — live, simulation-aware (Alpha+):** 24 `/v1/flow/*` endpoints.
  Analytics: `flowLevels` / `flowPinRisk` / `flowSummary` / `flowOi` /
  `flowGex` / `flowDex` / `flowDealerRisk` / `flowLive` — live gamma flip /
  walls / max pain, 0DTE pin score, flow direction + GEX shift, OI
  simulator state, flow-adjusted GEX/DEX, settled-vs-live dealer risk,
  all-in-one bundle. Signals: `flowSignals` / `flowSignalsSummary` —
  scored per-print signals (block/sweep, NBBO aggressor, opening/closing
  bias, intent) with 0-100 score + chain enrichment, plus net
  bullish/bearish + opening/closing premium roll-up. Raw:
  `flowOptionRecent|Summary|Blocks|History|Cumulative`, the `flowStock*`
  equivalents, and `flowOptionsLeaderboard|Outliers` /
  `flowStocksLeaderboard|Outliers`. Every method has a strongly-typed
  `*Typed` variant.

## Tiers (summary)

- **Free / Public** — health, surface, tickers, basic stock quotes.
- **Any** — GEX/DEX/VEX/CHEX, key levels, greeks, IV, stock summary.
- **Growth+** — exposure summary, 0DTE, narrative, max pain, option
  quotes, volatility.
- **Alpha+** — VRP, advanced volatility (SVI, variance swap, arb checks),
  the full `flow*` tier (24 simulation-aware + signals + raw flow endpoints).

Sign up for an API key at https://flashalpha.com.

## Links

- API playground: https://lab.flashalpha.com/swagger
- API key signup: https://flashalpha.com
- Other SDKs: Python (`pip install flashalpha`), JavaScript
  (`npm i flashalpha`), .NET (`dotnet add package FlashAlpha`), Go
  (`go get github.com/FlashAlpha-lab/flashalpha-go`), MCP server.