rc.10: pricing/iv/kelly, account, tickers, symbols, options-meta, health, screener TypedDicts + retyped client; rc.9 field-walk tests

Bump to 0.4.0rc10.

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

Author: tdobrowolski1

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "flashalpha"
-version = "0.4.0rc9"
+version = "0.4.0rc10"
 description = "Python SDK for the FlashAlpha options analytics API — live options screener, gamma exposure (GEX), VRP, delta, vanna, charm, greeks, 0DTE analytics, volatility surfaces, and more."
 readme = "README.md"
 license = "MIT"

src/flashalpha/__init__.py

@@ -119,6 +119,24 @@
     # ── Live-only Quote endpoints ──
     OptionQuoteResponse,
     StockQuoteResponse,
+    # ── Pricing IV ──
+    PricingIvInputs,
+    PricingIvResponse,
+    # ── Pricing Kelly ──
+    PricingKellyInputs,
+    PricingKellySizing,
+    PricingKellyAnalysis,
+    PricingKellyResponse,
+    # ── Account / Reference / System ──
+    AccountResponse,
+    TickersResponse,
+    SymbolsResponse,
+    OptionsMetaExpiration,
+    OptionsMetaResponse,
+    HealthResponse,
+    # ── Screener ──
+    ScreenerMeta,
+    ScreenerResponse,
 )
 
 __version__ = "0.4.0rc1"
@@ -242,4 +260,22 @@
     # ── Live-only Quote endpoints ──
     "OptionQuoteResponse",
     "StockQuoteResponse",
+    # ── Pricing IV (Free+, live-only) ──
+    "PricingIvResponse",
+    "PricingIvInputs",
+    # ── Pricing Kelly (Growth+, live-only) ──
+    "PricingKellyResponse",
+    "PricingKellyInputs",
+    "PricingKellySizing",
+    "PricingKellyAnalysis",
+    # ── Account / Reference / System ──
+    "AccountResponse",
+    "TickersResponse",
+    "SymbolsResponse",
+    "OptionsMetaResponse",
+    "OptionsMetaExpiration",
+    "HealthResponse",
+    # ── Screener ──
+    "ScreenerResponse",
+    "ScreenerMeta",
 ]

src/flashalpha/client.py

@@ -18,19 +18,27 @@
 
 if TYPE_CHECKING:
     from .types import (
+        AccountResponse,
         AdvVolatilityResponse,
         ChexResponse,
         DexResponse,
         ExposureLevelsResponse,
         ExposureSummaryResponse,
         GexResponse,
+        HealthResponse,
         MaxPainResponse,
         NarrativeResponse,
         OptionQuoteResponse,
+        OptionsMetaResponse,
         PricingGreeksResponse,
+        PricingIvResponse,
+        PricingKellyResponse,
+        ScreenerResponse,
         StockQuoteResponse,
         StockSummaryResponse,
         SurfaceResponse,
+        SymbolsResponse,
+        TickersResponse,
         VexResponse,
         VolatilityResponse,
         VrpResponse,
@@ -274,7 +282,7 @@ def iv(
         type: str = "call",
         r: float | None = None,
         q: float | None = None,
-    ) -> dict:
+    ) -> PricingIvResponse:
         """Implied volatility from market price."""
         params: dict[str, Any] = {"spot": spot, "strike": strike, "dte": dte, "price": price, "type": type}
         if r is not None:
@@ -295,7 +303,7 @@ def kelly(
         type: str = "call",
         r: float | None = None,
         q: float | None = None,
-    ) -> dict:
+    ) -> PricingKellyResponse:
         """Kelly criterion optimal position sizing. Requires Growth+."""
         params: dict[str, Any] = {
             "spot": spot,
@@ -324,15 +332,15 @@ def adv_volatility(self, symbol: str) -> AdvVolatilityResponse:
 
     # ── Reference Data ──────────────────────────────────────────────
 
-    def tickers(self) -> dict:
+    def tickers(self) -> TickersResponse:
         """All available stock tickers."""
         return self._get("/v1/tickers")
 
-    def options(self, ticker: str) -> dict:
+    def options(self, ticker: str) -> OptionsMetaResponse:
         """Option chain metadata (expirations + strikes)."""
         return self._get(f"/v1/options/{_seg(ticker)}")
 
-    def symbols(self) -> dict:
+    def symbols(self) -> SymbolsResponse:
         """Currently queried symbols with live data."""
         return self._get("/v1/symbols")
 
@@ -393,7 +401,7 @@ def screener(
         formulas: list[dict[str, str]] | None = None,
         limit: int | None = None,
         offset: int | None = None,
-    ) -> dict:
+    ) -> ScreenerResponse:
         """Live options screener — filter/rank symbols by gamma exposure, VRP,
         volatility, greeks, and more.
 
@@ -462,10 +470,10 @@ def screener(
 
     # ── Account & System ────────────────────────────────────────────
 
-    def account(self) -> dict:
+    def account(self) -> AccountResponse:
         """Account info and quota."""
         return self._get("/v1/account")
 
-    def health(self) -> dict:
+    def health(self) -> HealthResponse:
         """Health check (public, no auth required)."""
         return self._get("/health")