Skip to content

Releases: FlashAlpha-lab/flashalpha-python

v0.4.0-rc.1

05 May 18:22

Choose a tag to compare

v0.4.0-rc.1 Pre-release
Pre-release

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 omits neutral; the live response includes it when net_gex straddles zero.
  • hedging_estimate.*.direction is lowercase "buy"/"sell" on both /exposure/summary and /exposure/zero-dte. The API doc on /exposure/summary shows uppercase but live responses are lowercase. Type definitions reflect actual response.
  • as_of_requested exists 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

26 Mar 19:35

Choose a tag to compare

What's New

New Endpoints

  • zero_dte(symbol) — Real-time 0DTE analytics: gamma regime, expected move, pin risk scoring, dealer hedging, theta decay acceleration
  • exposure_history(symbol) — Daily exposure snapshots for trend analysis
  • adv_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.0

Full changelog: https://github.com/FlashAlpha-lab/flashalpha-python/blob/main/CHANGELOG.md