Add live Flow API tier (22 endpoints) + audit fixes

- Typed models + client methods + LLM-discoverable docs for all /v1/flow/*
  analytics + raw-flow endpoints; reuse existing Gex/Dex strike types
- Remove non-existent /v1/exposure/history endpoint
- Fix slices_used type (int count, was string[])
- Per-endpoint live integration tests; tolerate legit-null Optional fields

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: tdobrowolski1

README.md

@@ -231,7 +231,6 @@ Get your API key at **[flashalpha.com](https://flashalpha.com)**
 | `fa.exposure_summary(symbol)` | Full exposure summary with hedging | Growth+ |
 | `fa.narrative(symbol)` | AI narrative analysis | Growth+ |
 | `fa.zero_dte(symbol)` | 0DTE analytics (regime, pin risk, decay) | Growth+ |
-| `fa.exposure_history(symbol)` | Daily exposure snapshots | Growth+ |
 | `fa.stock_quote(ticker)` | Live stock quote | Free+ |
 | `fa.option_quote(ticker)` | Option quotes with greeks | Growth+ |
 | `fa.stock_summary(symbol)` | Comprehensive stock summary | Public/Free+ |

docs/api.md

@@ -66,7 +66,6 @@ https://lab.flashalpha.com/v1/symbols?apiKey=YOUR_API_KEY
 - [`GET /v1/exposure/narrative/{symbol}`](#get-v1exposurenarrativesymbol) — Verbal narrative analysis `Growth+`
 - [`GET /v1/exposure/zero-dte/{symbol}`](#get-v1exposurezero-dtesymbol) — Real-time 0DTE analytics `Growth+`
 - [`GET /v1/maxpain/{symbol}`](#get-v1maxpainsymbol) — Max pain analysis with dealer alignment `Basic+`
-- [`GET /v1/exposure/history/{symbol}`](#get-v1exposurehistorysymbol) — Daily exposure history `Growth+` *(coming soon)*
 
 ### Pricing & Sizing
 
@@ -998,54 +997,6 @@ If the symbol has no 0DTE expiry today (e.g. SPY on Tuesday/Thursday):
 - `strike_range` only filters the `strikes` array — all aggregate calculations use the full 0DTE chain
 - All calculations are pure static (no external calls beyond the initial data fetch)
 
----
-
-## `GET /v1/exposure/history/{symbol}`
-
-Returns daily exposure snapshots for trend analysis. Data is stored end-of-day and returned newest first.
-
-**Requires Growth plan or higher.** *Currently returns `503 coming_soon`.*
-
-### Parameters
-
-| Name | In | Required | Default | Description |
-|------|----|----------|---------|-------------|
-| `symbol` | path | yes | — | Underlying symbol |
-| `days` | query | no | `30` | Days of history (1-365) |
-
-### Example
-
-```bash
-curl -H "X-Api-Key: YOUR_API_KEY" \
-  "https://lab.flashalpha.com/v1/exposure/history/SPY?days=7"
-```
-
-### Response `200` *(when available)*
-
-```json
-{
-  "symbol": "SPY",
-  "days": 7,
-  "count": 5,
-  "snapshots": [
-    {
-      "date": "2026-02-28",
-      "underlying_price": 597.505,
-      "net_gex": 2850000000,
-      "net_dex": -450000000,
-      "net_vex": 1200000000,
-      "net_chex": 850000000,
-      "gamma_flip": 595.25,
-      "call_wall": 600.0,
-      "put_wall": 595.0,
-      "regime": "positive_gamma"
-    }
-  ]
-}
-```
-
----
-
 ## `GET /v1/maxpain/{symbol}`
 
 Returns max pain analysis for a symbol — the strike where total option holder payout is minimized. Includes pain curve, OI breakdown, dealer alignment overlay (gamma flip, call/put walls), expected move context, pin probability, and multi-expiry calendar.

src/flashalpha/__init__.py

@@ -16,6 +16,40 @@
     ExposureSummaryInterpretation,
     ExposureSummaryResponse,
     ExposureSummaryZeroDte,
+    FlowAdjustedDealerRisk,
+    FlowCumulativePoint,
+    FlowDealerRiskResponse,
+    FlowDexResponse,
+    FlowGexResponse,
+    FlowLevelsResponse,
+    FlowLiveResponse,
+    FlowOiResponse,
+    FlowOptionBlock,
+    FlowOptionBlocksResponse,
+    FlowOptionCumulativeResponse,
+    FlowOptionHistoryBucket,
+    FlowOptionHistoryResponse,
+    FlowOptionLeaderRow,
+    FlowOptionLeaderboardResponse,
+    FlowOptionOutliersResponse,
+    FlowOptionRecentResponse,
+    FlowOptionSummaryResponse,
+    FlowOptionTrade,
+    FlowOutlierRow,
+    FlowPinRiskBreakdown,
+    FlowPinRiskResponse,
+    FlowStockBlock,
+    FlowStockBlocksResponse,
+    FlowStockCumulativeResponse,
+    FlowStockHistoryBucket,
+    FlowStockHistoryResponse,
+    FlowStockLeaderRow,
+    FlowStockLeaderboardResponse,
+    FlowStockOutliersResponse,
+    FlowStockRecentResponse,
+    FlowStockSummaryResponse,
+    FlowStockTrade,
+    FlowSummaryResponse,
     VrpCore,
     VrpDirectional,
     VrpGexConditioned,
@@ -278,4 +312,39 @@
     # ── Screener ──
     "ScreenerResponse",
     "ScreenerMeta",
+    # ── Flow (live, simulation-aware) ──
+    "FlowLevelsResponse",
+    "FlowPinRiskResponse",
+    "FlowPinRiskBreakdown",
+    "FlowSummaryResponse",
+    "FlowOiResponse",
+    "FlowGexResponse",
+    "FlowDexResponse",
+    "FlowDealerRiskResponse",
+    "FlowAdjustedDealerRisk",
+    "FlowLiveResponse",
+    "FlowOptionTrade",
+    "FlowOptionRecentResponse",
+    "FlowOptionSummaryResponse",
+    "FlowOptionBlock",
+    "FlowOptionBlocksResponse",
+    "FlowOptionHistoryBucket",
+    "FlowOptionHistoryResponse",
+    "FlowCumulativePoint",
+    "FlowOptionCumulativeResponse",
+    "FlowStockTrade",
+    "FlowStockRecentResponse",
+    "FlowStockSummaryResponse",
+    "FlowStockBlock",
+    "FlowStockBlocksResponse",
+    "FlowStockHistoryBucket",
+    "FlowStockHistoryResponse",
+    "FlowStockCumulativeResponse",
+    "FlowOptionLeaderRow",
+    "FlowOptionLeaderboardResponse",
+    "FlowOutlierRow",
+    "FlowOptionOutliersResponse",
+    "FlowStockLeaderRow",
+    "FlowStockLeaderboardResponse",
+    "FlowStockOutliersResponse",
 ]