flashalpha 0.3.2__tar.gz → 0.3.4__tar.gz

{flashalpha-0.3.2 → flashalpha-0.3.4}/.claude/settings.json

@@ -45,7 +45,8 @@
       "Bash(npm config:*)",
       "Bash(export PATH=\"$PATH:/c/Program Files/Go/bin\")",
       "Bash(go test:*)",
-      "Bash(FLASHALPHA_API_KEY=\"ejbe0oW5f4n7C7drEg7Ggo6bPtFuFpaLPmvmkDrE\" \"C:/Users/disea/tools/apache-maven-3.9.14/bin/mvn.cmd\" test -Dtest=\"IntegrationTest#testMaxPain*\")"
+      "Bash(FLASHALPHA_API_KEY=\"ejbe0oW5f4n7C7drEg7Ggo6bPtFuFpaLPmvmkDrE\" \"C:/Users/disea/tools/apache-maven-3.9.14/bin/mvn.cmd\" test -Dtest=\"IntegrationTest#testMaxPain*\")",
+      "Bash(grep -iE \"ejbe0oW5|oy2fcywr|npm_UsjzA|npm_7rHFG|WfdTfVm|ujxFMb|pypi-AgEI|fa_[a-zA-Z0-9]{20,}|FLASHALPHA_API_KEY=.{10,}\")"
     ],
     "additionalDirectories": [
       "C:\\Users\\disea"

flashalpha-0.3.4/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+## Unreleased
+
+### Added
+- `docs/api.md` — full endpoint reference, URL-prefix table, response schemas, and sample JSON for every endpoint (copied from flashalpha-api)
+- 17 integration regression tests (`tests/test_integration.py`) guarding against response-shape and URL-pattern regressions reported by Alpha users:
+  - Nested VRP response (`vrp.z_score`, `gex_conditioned.harvest_score`, `regime.net_gex`, `directional.*`)
+  - `exposure_summary` nesting (`exposures.net_gex`)
+  - VRP directional field names (`downside_vrp`/`upside_vrp`, not `put_vrp`/`call_vrp`)
+  - URL-prefix mix — `/stockquote`, `/optionquote`, `/historical/*` without `/v1/`; everything else with
+  - `/v1/stock/{sym}/summary` canonical vs `/v1/summary/{sym}` 404
+  - Canonical `POST /v1/screener` + `/v1/screener/live` deprecation
+  - `/v1/vrp/{sym}` REST endpoint (until `vrp()` method ships)
+
+## 0.3.2 (2026-04-07)
+
+### Added
+- `max_pain()` — max pain analysis with dealer alignment overlay, pain curve, OI breakdown, expected move context, pin probability, and multi-expiry calendar (Growth+)
+
+## 0.3.1 (2026-04-02)
+
+### Changed
+- Screener endpoint renamed: `/v1/screener/live` → `/v1/screener` (canonical). The SDK's `screener()` method now POSTs to `/v1/screener`.
+
+## 0.3.0 (2026-03-30)
+
+### Added
+- `screener()` — live options screener. Filter/rank symbols by gamma exposure, VRP, volatility, greeks, harvest scores, and custom formulas. Growth: 10-symbol universe, up to 10 rows. Alpha: ~250 symbols, up to 50 rows, formulas, and harvest/dealer-flow-risk scores.
+- Recursive filter trees (leaf + `and`/`or` groups), cascading filters via `expiries.*` / `strikes.*` / `contracts.*` prefixes, multi-sort, pagination, inline and named formulas, `select=["*"]` for the full flat object.
+- Unit + integration test coverage for screener filter tree, operators, formulas, and tier gating.
+
+## 0.2.0 (2026-03-26)
+
+### Added
+- `zero_dte()` — real-time 0DTE analytics (regime, pin risk, expected move, hedging, decay)
+- `exposure_history()` — daily exposure snapshots for trend analysis
+- `adv_volatility()` — advanced volatility analytics (SVI parameters, variance surface, arbitrage detection, greeks surfaces, variance swap pricing)
+- Comprehensive method reference table in README
+- SEO-optimized keywords in PyPI metadata
+
+### Changed
+- Updated API plans table to reflect current tiers (Free/Basic/Growth/Alpha)
+- Improved README structure and documentation
+
+## 0.1.0 (2026-03-13)
+
+### Added
+- Initial release
+- Core client with all FlashAlpha API endpoints
+- Exposure analytics: `gex()`, `dex()`, `vex()`, `chex()`, `exposure_levels()`, `exposure_summary()`, `narrative()`
+- Market data: `stock_quote()`, `option_quote()`, `stock_summary()`, `surface()`
+- Historical data: `historical_stock_quote()`, `historical_option_quote()`
+- Pricing: `greeks()`, `iv()`, `kelly()`
+- Volatility: `volatility()`
+- Reference: `tickers()`, `options()`, `symbols()`, `account()`, `health()`
+- Error handling: `AuthenticationError`, `TierRestrictedError`, `NotFoundError`, `RateLimitError`, `ServerError`
+- 36 unit tests, 23 integration tests

flashalpha-0.3.4/CLAUDE.md

@@ -0,0 +1,67 @@
+# CLAUDE.md
+
+Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
+
+**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.
+
+## 1. Think Before Coding
+
+**Don't assume. Don't hide confusion. Surface tradeoffs.**
+
+Before implementing:
+- State your assumptions explicitly. If uncertain, ask.
+- If multiple interpretations exist, present them - don't pick silently.
+- If a simpler approach exists, say so. Push back when warranted.
+- If something is unclear, stop. Name what's confusing. Ask.
+
+## 2. Simplicity First
+
+**Minimum code that solves the problem. Nothing speculative.**
+
+- No features beyond what was asked.
+- No abstractions for single-use code.
+- No "flexibility" or "configurability" that wasn't requested.
+- No error handling for impossible scenarios.
+- If you write 200 lines and it could be 50, rewrite it.
+
+Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
+
+## 3. Surgical Changes
+
+**Touch only what you must. Clean up only your own mess.**
+
+When editing existing code:
+- Don't "improve" adjacent code, comments, or formatting.
+- Don't refactor things that aren't broken.
+- Match existing style, even if you'd do it differently.
+- If you notice unrelated dead code, mention it - don't delete it.
+
+When your changes create orphans:
+- Remove imports/variables/functions that YOUR changes made unused.
+- Don't remove pre-existing dead code unless asked.
+
+The test: Every changed line should trace directly to the user's request.
+
+## 4. Goal-Driven Execution
+
+**Define success criteria. Loop until verified.**
+
+Transform tasks into verifiable goals:
+- "Add validation" → "Write tests for invalid inputs, then make them pass"
+- "Fix the bug" → "Write a test that reproduces it, then make it pass"
+- "Refactor X" → "Ensure tests pass before and after"
+
+For multi-step tasks, state a brief plan:
+```
+1. [Step] → verify: [check]
+2. [Step] → verify: [check]
+3. [Step] → verify: [check]
+```
+
+Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.
+
+---
+
+**These guidelines are working if:** fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes.
+
+_Source: [forrestchang/andrej-karpathy-skills](https://github.com/forrestchang/andrej-karpathy-skills)_

{flashalpha-0.3.2 → flashalpha-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flashalpha
-Version: 0.3.2
+Version: 0.3.4
 Summary: 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.
 Project-URL: Homepage, https://flashalpha.com
 Project-URL: Documentation, https://flashalpha.com/docs
@@ -273,6 +273,7 @@ Get your API key at **[flashalpha.com](https://flashalpha.com)**
 | `fa.greeks(...)` | BSM greeks (1st, 2nd, 3rd order) | Free+ |
 | `fa.iv(...)` | Implied volatility solver | Free+ |
 | `fa.kelly(...)` | Kelly criterion sizing | Growth+ |
+| `fa.max_pain(symbol)` | Max pain analysis with dealer alignment, pain curve, pin probability | Growth+ |
 | `fa.screener(...)` | **Live options screener** — filter/rank by GEX, VRP, IV, greeks, formulas | Growth+ |
 | `fa.volatility(symbol)` | Comprehensive volatility analytics | Growth+ |
 | `fa.adv_volatility(symbol)` | SVI, variance surface, arb detection | Alpha+ |

{flashalpha-0.3.2 → flashalpha-0.3.4}/README.md

@@ -241,6 +241,7 @@ Get your API key at **[flashalpha.com](https://flashalpha.com)**
 | `fa.greeks(...)` | BSM greeks (1st, 2nd, 3rd order) | Free+ |
 | `fa.iv(...)` | Implied volatility solver | Free+ |
 | `fa.kelly(...)` | Kelly criterion sizing | Growth+ |
+| `fa.max_pain(symbol)` | Max pain analysis with dealer alignment, pain curve, pin probability | Growth+ |
 | `fa.screener(...)` | **Live options screener** — filter/rank by GEX, VRP, IV, greeks, formulas | Growth+ |
 | `fa.volatility(symbol)` | Comprehensive volatility analytics | Growth+ |
 | `fa.adv_volatility(symbol)` | SVI, variance surface, arb detection | Alpha+ |