Releases: FlashAlpha-lab/flashalpha-python
Releases · FlashAlpha-lab/flashalpha-python
v0.4.0-rc.1
Release candidate 0.4.0-rc.1
This release candidate adds typed POCO models for the /v1/exposure/summary/{symbol} endpoint and tightens integration test coverage to reference every declared field.
What's new:
ExposureSummaryResponse+ 5 sub-types (Exposures,Interpretation,HedgingMove,HedgingEstimate,ZeroDte)- Field-level nullability aligned across all 5 SDK languages
- Integration test references 100% of declared fields
API behaviour clarifications (live + historical probes):
regime ∈ {positive_gamma, negative_gamma, neutral, undetermined}. The original API doc text omitsneutral; the live response includes it when net_gex straddles zero.hedging_estimate.*.directionis lowercase"buy"/"sell"on both/exposure/summaryand/exposure/zero-dte. The API doc on/exposure/summaryshows uppercase but live responses are lowercase. Type definitions reflect actual response.as_of_requestedexists on/exposure/{gex,dex,narrative}but not on/exposure/summary.
Backwards-compatible: Existing untyped methods continue to work unchanged. Typed return-type annotations (Python TypedDict, TS interface) are non-breaking. Java/C#/Go new POCO types are additive.
This is a release candidate. Final 0.4.0 will follow once VRP and other nested-trap endpoints get the same POCO treatment.
v0.2.0
What's New
New Endpoints
zero_dte(symbol)— Real-time 0DTE analytics: gamma regime, expected move, pin risk scoring, dealer hedging, theta decay accelerationexposure_history(symbol)— Daily exposure snapshots for trend analysisadv_volatility(symbol)— Advanced volatility analytics: SVI parameters, variance surface, arbitrage detection, greeks surfaces, variance swap pricing
Improvements
- SEO-optimized README with full method reference table
- Updated API plans (Free/Basic/Growth/Alpha)
- Added 9 new PyPI keywords (0dte, volatility surface, SVI, variance swap, etc.)
- CI workflow with Python 3.10–3.13
- CHANGELOG and CONTRIBUTING guides
- Cross-links to all related repositories
Test Coverage
- 36 unit tests (mocked)
- 23 integration tests (live API)
Install
pip install flashalpha==0.2.0Full changelog: https://github.com/FlashAlpha-lab/flashalpha-python/blob/main/CHANGELOG.md