options-analysis-suite 0.1.0a1__tar.gz

options_analysis_suite-0.1.0a1/.gitignore

@@ -0,0 +1,24 @@
+# Build artifacts
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Virtual envs
+.venv/
+venv/
+env/
+
+# Caches
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store

options_analysis_suite-0.1.0a1/CHANGELOG.md

@@ -0,0 +1,75 @@
+# Changelog
+
+All notable changes to the `options-analysis-suite` Python SDK are documented
+in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and the project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+While the SDK is in `0.x`, the public surface may change between minor
+releases — pin to a specific `0.0.x` if you need stability. Breaking changes
+will be called out in this file with **Breaking** at the start of the bullet.
+
+## [Unreleased]
+
+## [0.1.0a1] — 2026-04-28
+
+First public alpha. Architecture decided, full surface implemented, drift
+checked against the deployed OpenAPI spec.
+
+### Added
+
+- `OASClient` with 49 typed methods covering every typed `/v1/*` operationId
+  from the data-api OpenAPI spec.
+  - **Compute (9):** `price`, `greeks`, `exposure`, `scenario`, `sensitivity`,
+    `max_pain`, `expected_move`, `probability` (+ `probability_simple` /
+    `probability_full` typed helpers), `calibrate`.
+  - **Data (40):** snapshot, metrics, regime, IV surface, Greeks history,
+    scanner, market structure (ATS/OTC/blocks), calendars (economic/IPO/
+    dividend/split), corporate actions, news, history, FRED, Treasury
+    auctions, bond ETF + TRACE.
+- `Calibration` domain helper that wraps a `/v1/compute/calibrate` result.
+  - `cal.price(...)` / `cal.greeks(...)` forward `modelParams=cal.params`
+    automatically.
+  - `cal.save("path.json")` / `Calibration.from_json("path.json", client=...)`
+    for durable persistence; the 30-second-only `calibrationId` is
+    intentionally not surfaced.
+  - `_format_version=1` written to disk; loading newer files raises
+    `ValueError`.
+  - Symbol forwarding to `/price` / `/greeks` is suppressed only when the
+    caller supplies full numeric inputs **including** numeric `t`, so
+    compute-only API keys don't trip the server's data-scope check.
+- `iter_metrics(symbols, batch_size=50)` — chunks a large symbol list across
+  `/v1/data/metrics/batch` calls.
+- Typed exceptions: `OASError`, `AuthenticationError`, `ValidationError`,
+  `PermissionDeniedError` (with `.required_scope`), `NotFoundError`,
+  `RateLimitError` (with `.retry_after`, `.bucket`), `CalibrationQuotaError`
+  (with `.resets_at`), `ConcurrencyLimitError` (with `.current`, `.max`),
+  `ServerError`.
+- `BrokerCredentials` BYOK helpers: `TradierCredentials(token=...)`,
+  `TastytradeCredentials(refresh_token=..., client_secret=...)`.
+- Generated Pydantic v2 response models in `oas._generated.models`
+  (88 classes from the OpenAPI spec). Post-processed to use
+  `extra='ignore'` so additive server fields don't break older SDK
+  versions.
+- Drift-test suite (`tests/test_drift.py`) gates SDK coverage against
+  `/openapi.json`. Strict-equality gate enabled.
+- Pinned spec fixture at `tests/fixtures/openapi.snapshot.json` for offline
+  test runs; `make test-live` checks freshness against deployed prod.
+
+### Notes
+
+- `py.typed` is intentionally **not** shipped in this release: the
+  hand-written surface (client/errors/credentials/transport) is mypy-strict
+  clean, but the auto-generated module has type-check warnings that won't
+  resolve until `datamodel-code-generator` produces fully mypy-clean output.
+  Methods still return typed Pydantic models at runtime.
+- `Typing :: Typed` classifier withheld for the same reason.
+- ListResponse-backed methods return `dict[str, Any]` so server-side
+  top-level metadata (date, page, count, direction, etc.) is preserved.
+  These will tighten to typed models as endpoint-specific schemas land
+  upstream.
+- Sync-only client. `AsyncOASClient` deferred until there's a user need.
+
+[Unreleased]: https://github.com/Options-Analysis-Suite/options-analysis-suite-python/compare/v0.1.0a1...HEAD
+[0.1.0a1]: https://github.com/Options-Analysis-Suite/options-analysis-suite-python/releases/tag/v0.1.0a1

options_analysis_suite-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Options Analysis Suite
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

options_analysis_suite-0.1.0a1/Makefile

@@ -0,0 +1,40 @@
+.PHONY: install gen lint typecheck test test-live build clean
+
+# Lint/typecheck/test targets route through ./.venv/bin/* so they work
+# without activating the virtualenv first. `make install` provisions .venv
+# via uv. `make build` calls `uv build` directly (no .venv lookup needed).
+PY := .venv/bin/python
+PYTEST := .venv/bin/pytest
+RUFF := .venv/bin/ruff
+MYPY := .venv/bin/mypy
+
+install:
+	uv venv --python 3.12 .venv
+	uv pip install --python .venv -e ".[dev,codegen]"
+
+# Re-derive Pydantic models from the live OpenAPI spec. Requires datamodel-codegen.
+gen:
+	$(PY) scripts/gen_models.py
+
+lint:
+	$(RUFF) check src tests scripts
+
+typecheck:
+	$(MYPY)
+
+# Unit + drift tests (no network). Reads tests/fixtures/openapi.snapshot.json by
+# default; set OAS_OPENAPI_PATH=- to force a live fetch instead.
+test:
+	$(PYTEST) -m "not live" -v
+
+# Integration test against the deployed API. Requires OAS_API_KEY in env.
+# Also runs the fixture-freshness check that diffs the pinned snapshot against
+# the live /openapi.json — refresh tests/fixtures/openapi.snapshot.json if it fails.
+test-live:
+	$(PYTEST) -m live -v
+
+build:
+	uv build
+
+clean:
+	rm -rf build dist *.egg-info src/oas.egg-info .pytest_cache .mypy_cache .ruff_cache

options_analysis_suite-0.1.0a1/PKG-INFO

@@ -0,0 +1,221 @@
+Metadata-Version: 2.4
+Name: options-analysis-suite
+Version: 0.1.0a1
+Summary: Python SDK for the Options Analysis Suite API: 17 pricing models, auto-calibration, GEX/DEX exposure, IV surfaces, and pre-computed market data.
+Project-URL: Homepage, https://optionsanalysissuite.com
+Project-URL: Documentation, https://data.optionsanalysissuite.com/docs
+Project-URL: Repository, https://github.com/Options-Analysis-Suite/options-analysis-suite-python
+Project-URL: Changelog, https://github.com/Options-Analysis-Suite/options-analysis-suite-python/blob/main/CHANGELOG.md
+Author: Options Analysis Suite
+License: MIT
+License-File: LICENSE
+Keywords: calibration,exposure,greeks,heston,options,quant,sabr,trading
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.10
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: pydantic<3.0,>=2.5
+Provides-Extra: codegen
+Requires-Dist: datamodel-code-generator>=0.26; extra == 'codegen'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest>=7.4; extra == 'dev'
+Requires-Dist: respx>=0.20; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Options Analysis Suite — Python SDK
+
+Type-safe Python client for the [Options Analysis Suite API](https://optionsanalysissuite.com).
+
+> **Status: alpha (`0.1.0a1`)** — full coverage of every typed `/v1/*`
+> operationId, plus a `Calibration` domain helper. Drift-checked against
+> the deployed OpenAPI spec.
+
+## Install
+
+```bash
+pip install options-analysis-suite
+```
+
+> Available on PyPI after the first `v*` tag is published. Until then,
+> install from source with `pip install -e .` from a repo checkout.
+
+## Quickstart
+
+```python
+from oas import OASClient, TradierCredentials
+
+with OASClient(api_key="oas_live_...") as client:
+    # Data: cached EOD analytics
+    snap = client.snapshot("SPY")
+    print(snap.atmIv, snap.netGex, snap.maxPain)
+
+    if snap.maxPainCurve:
+        for row in snap.maxPainCurve:
+            print(row.strike, row.totalPain)
+
+    # Compute: 17 pricing models, full Greeks, exposure, expected move...
+    price = client.price(model="bs", is_call=True, S=650, K=650, r=0.05,
+                         q=0.012, sigma=0.15, t=0.25)
+    greeks = client.greeks(model="heston", is_call=True, S=650, K=650, r=0.05,
+                           q=0.012, sigma=0.15, t=0.25)
+
+    # Calibrate once, persist, reuse — never re-touches the calibrationId TTL.
+    cal = client.calibrate(
+        "SPY", model="heston",
+        broker=TradierCredentials(token="..."),
+    )
+    cal.save("spy_heston.json")
+
+    # Evaluate the calibrated model anywhere across the chain.
+    fair = cal.price(is_call=True, K=655, expiry="2026-06-19")
+
+    # Stream batched metrics without manually paging.
+    for m in client.iter_metrics(["SPY", "QQQ", "IWM", "DIA"], batch_size=50):
+        print(m.symbol, m.ivRank)
+```
+
+## Calibration round-trip
+
+A `Calibration` is the durable wrapper around a `/v1/compute/calibrate` result.
+The fitted `params` dict survives a JSON round-trip; the 30-second-only
+`calibrationId` is intentionally not surfaced.
+
+```python
+# Load a saved calibration in another process / hours later.
+from oas import Calibration, OASClient
+
+cal = Calibration.from_json("spy_heston.json")
+with OASClient(api_key="oas_live_...") as client:
+    cal.bind(client)  # attach so cal.price() / cal.greeks() can fire HTTP
+    price = cal.price(is_call=True, K=650, S=650, r=0.05, q=0.012,
+                      sigma=0.15, t=0.25)
+```
+
+## Errors
+
+Every error subclass carries the HTTP status, the server's structured `code`
+field (when present), and any extra fields the server returned.
+
+```python
+from oas.errors import NotFoundError, RateLimitError, CalibrationQuotaError
+
+try:
+    snap = client.snapshot("UNKNOWN")
+except NotFoundError as e:
+    print(f"warehouse miss: {e}")
+except RateLimitError as e:
+    print(f"slow down — retry in {e.retry_after}s (bucket: {e.bucket})")
+except CalibrationQuotaError as e:
+    print(f"calibration quota exhausted; resets at {e.resets_at}")
+```
+
+See [`src/oas/errors.py`](src/oas/errors.py) for the full hierarchy.
+
+## Models
+
+Response models live in `oas._generated.models` and are auto-generated from
+the OpenAPI spec at build time. The generated classes use `extra='ignore'`
+so additive server fields (e.g., a new metric in `MetricsResponse`) don't
+break older SDK versions — older SDKs will simply omit unknown fields.
+
+To regenerate against the latest spec:
+
+```bash
+make gen
+```
+
+## Development
+
+```bash
+# Set up dev env
+make install
+
+# Lint / typecheck / test
+make lint
+make typecheck
+make test         # unit + drift, no network. Uses tests/fixtures/openapi.snapshot.json
+make test-live    # integration (needs OAS_API_KEY env var). Also re-checks the
+                  # pinned spec fixture against the deployed /openapi.json.
+                  # Refresh the fixture with:
+                  #   curl -s https://data.optionsanalysissuite.com/openapi.json \
+                  #     > tests/fixtures/openapi.snapshot.json
+
+# Build distribution
+make build
+```
+
+## Drift gate
+
+The SDK's `_manifest.py` registers every operationId → `OASClient` method
+pairing. `tests/test_drift.py` runs four checks against the spec:
+
+1. Every `ENDPOINTS` operationId actually exists in `/openapi.json`
+2. Every registered `Endpoint.sdk_method` resolves to a real `OASClient` attr
+3. Every registered `Endpoint.path` is a path in the spec
+4. **Strict gate**: spec ops − ignored − expected-missing == `ENDPOINTS` keys.
+   Catches both unfinished stubs left in the allowlist and surprise spec
+   additions.
+
+The `EXPECTED_MISSING_OPERATION_IDS` allowlist is **empty** — the SDK
+covers every typed operation. The `live` test suite double-checks that
+the pinned `tests/fixtures/openapi.snapshot.json` still matches deployed
+prod.
+
+## Release process (maintainers)
+
+Releases are tag-driven via the `publish.yml` GitHub Actions workflow.
+The publish job uses [PyPI Trusted Publishing](https://docs.pypi.org/trusted-publishers/)
+(OIDC) — no API tokens are stored anywhere.
+
+**One-time setup (on PyPI):**
+
+1. Visit https://pypi.org/manage/account/publishing/
+2. Add a pending publisher with:
+   - Owner: `Options-Analysis-Suite`
+   - Repository: `options-analysis-suite-python`
+   - Workflow filename: `publish.yml`
+   - Environment: `pypi`
+3. (After the first publish, the project will exist on PyPI and the
+   pending publisher becomes a regular trusted publisher.)
+
+**One-time setup (on GitHub):**
+
+The publish job runs in a GitHub environment named `pypi` (see
+`environment: pypi` in `publish.yml`). Create it under **Settings →
+Environments → New environment**. Optional but recommended: require
+manual approval, restrict to the `main` branch, and add reviewers so a
+stray tag push can't ship to PyPI without a human in the loop.
+
+**Per-release:**
+
+1. Bump `version` in `pyproject.toml` to the new version
+   (e.g. `0.1.0a1` → `0.1.0`).
+2. Update `CHANGELOG.md` under the new version heading; move
+   `[Unreleased]` items into it.
+3. Commit (`chore: release vX.Y.Z`).
+4. Tag the commit: `git tag vX.Y.Z` (the `v` prefix is required — the
+   publish workflow only triggers on tags matching `v*`).
+5. Push the tag: `git push origin vX.Y.Z`.
+
+The workflow:
+- Verifies the tag's version matches `pyproject.toml`
+- Runs lint + typecheck + offline tests
+- Builds sdist + wheel via `uv build`
+- Publishes to PyPI through the OIDC trusted publisher
+
+If the tag-vs-pyproject guard fails, fix `pyproject.toml`, retag with
+`git tag -d` + recreate, and re-push.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

options_analysis_suite-0.1.0a1/README.md

@@ -0,0 +1,187 @@
+# Options Analysis Suite — Python SDK
+
+Type-safe Python client for the [Options Analysis Suite API](https://optionsanalysissuite.com).
+
+> **Status: alpha (`0.1.0a1`)** — full coverage of every typed `/v1/*`
+> operationId, plus a `Calibration` domain helper. Drift-checked against
+> the deployed OpenAPI spec.
+
+## Install
+
+```bash
+pip install options-analysis-suite
+```
+
+> Available on PyPI after the first `v*` tag is published. Until then,
+> install from source with `pip install -e .` from a repo checkout.
+
+## Quickstart
+
+```python
+from oas import OASClient, TradierCredentials
+
+with OASClient(api_key="oas_live_...") as client:
+    # Data: cached EOD analytics
+    snap = client.snapshot("SPY")
+    print(snap.atmIv, snap.netGex, snap.maxPain)
+
+    if snap.maxPainCurve:
+        for row in snap.maxPainCurve:
+            print(row.strike, row.totalPain)
+
+    # Compute: 17 pricing models, full Greeks, exposure, expected move...
+    price = client.price(model="bs", is_call=True, S=650, K=650, r=0.05,
+                         q=0.012, sigma=0.15, t=0.25)
+    greeks = client.greeks(model="heston", is_call=True, S=650, K=650, r=0.05,
+                           q=0.012, sigma=0.15, t=0.25)
+
+    # Calibrate once, persist, reuse — never re-touches the calibrationId TTL.
+    cal = client.calibrate(
+        "SPY", model="heston",
+        broker=TradierCredentials(token="..."),
+    )
+    cal.save("spy_heston.json")
+
+    # Evaluate the calibrated model anywhere across the chain.
+    fair = cal.price(is_call=True, K=655, expiry="2026-06-19")
+
+    # Stream batched metrics without manually paging.
+    for m in client.iter_metrics(["SPY", "QQQ", "IWM", "DIA"], batch_size=50):
+        print(m.symbol, m.ivRank)
+```
+
+## Calibration round-trip
+
+A `Calibration` is the durable wrapper around a `/v1/compute/calibrate` result.
+The fitted `params` dict survives a JSON round-trip; the 30-second-only
+`calibrationId` is intentionally not surfaced.
+
+```python
+# Load a saved calibration in another process / hours later.
+from oas import Calibration, OASClient
+
+cal = Calibration.from_json("spy_heston.json")
+with OASClient(api_key="oas_live_...") as client:
+    cal.bind(client)  # attach so cal.price() / cal.greeks() can fire HTTP
+    price = cal.price(is_call=True, K=650, S=650, r=0.05, q=0.012,
+                      sigma=0.15, t=0.25)
+```
+
+## Errors
+
+Every error subclass carries the HTTP status, the server's structured `code`
+field (when present), and any extra fields the server returned.
+
+```python
+from oas.errors import NotFoundError, RateLimitError, CalibrationQuotaError
+
+try:
+    snap = client.snapshot("UNKNOWN")
+except NotFoundError as e:
+    print(f"warehouse miss: {e}")
+except RateLimitError as e:
+    print(f"slow down — retry in {e.retry_after}s (bucket: {e.bucket})")
+except CalibrationQuotaError as e:
+    print(f"calibration quota exhausted; resets at {e.resets_at}")
+```
+
+See [`src/oas/errors.py`](src/oas/errors.py) for the full hierarchy.
+
+## Models
+
+Response models live in `oas._generated.models` and are auto-generated from
+the OpenAPI spec at build time. The generated classes use `extra='ignore'`
+so additive server fields (e.g., a new metric in `MetricsResponse`) don't
+break older SDK versions — older SDKs will simply omit unknown fields.
+
+To regenerate against the latest spec:
+
+```bash
+make gen
+```
+
+## Development
+
+```bash
+# Set up dev env
+make install
+
+# Lint / typecheck / test
+make lint
+make typecheck
+make test         # unit + drift, no network. Uses tests/fixtures/openapi.snapshot.json
+make test-live    # integration (needs OAS_API_KEY env var). Also re-checks the
+                  # pinned spec fixture against the deployed /openapi.json.
+                  # Refresh the fixture with:
+                  #   curl -s https://data.optionsanalysissuite.com/openapi.json \
+                  #     > tests/fixtures/openapi.snapshot.json
+
+# Build distribution
+make build
+```
+
+## Drift gate
+
+The SDK's `_manifest.py` registers every operationId → `OASClient` method
+pairing. `tests/test_drift.py` runs four checks against the spec:
+
+1. Every `ENDPOINTS` operationId actually exists in `/openapi.json`
+2. Every registered `Endpoint.sdk_method` resolves to a real `OASClient` attr
+3. Every registered `Endpoint.path` is a path in the spec
+4. **Strict gate**: spec ops − ignored − expected-missing == `ENDPOINTS` keys.
+   Catches both unfinished stubs left in the allowlist and surprise spec
+   additions.
+
+The `EXPECTED_MISSING_OPERATION_IDS` allowlist is **empty** — the SDK
+covers every typed operation. The `live` test suite double-checks that
+the pinned `tests/fixtures/openapi.snapshot.json` still matches deployed
+prod.
+
+## Release process (maintainers)
+
+Releases are tag-driven via the `publish.yml` GitHub Actions workflow.
+The publish job uses [PyPI Trusted Publishing](https://docs.pypi.org/trusted-publishers/)
+(OIDC) — no API tokens are stored anywhere.
+
+**One-time setup (on PyPI):**
+
+1. Visit https://pypi.org/manage/account/publishing/
+2. Add a pending publisher with:
+   - Owner: `Options-Analysis-Suite`
+   - Repository: `options-analysis-suite-python`
+   - Workflow filename: `publish.yml`
+   - Environment: `pypi`
+3. (After the first publish, the project will exist on PyPI and the
+   pending publisher becomes a regular trusted publisher.)
+
+**One-time setup (on GitHub):**
+
+The publish job runs in a GitHub environment named `pypi` (see
+`environment: pypi` in `publish.yml`). Create it under **Settings →
+Environments → New environment**. Optional but recommended: require
+manual approval, restrict to the `main` branch, and add reviewers so a
+stray tag push can't ship to PyPI without a human in the loop.
+
+**Per-release:**
+
+1. Bump `version` in `pyproject.toml` to the new version
+   (e.g. `0.1.0a1` → `0.1.0`).
+2. Update `CHANGELOG.md` under the new version heading; move
+   `[Unreleased]` items into it.
+3. Commit (`chore: release vX.Y.Z`).
+4. Tag the commit: `git tag vX.Y.Z` (the `v` prefix is required — the
+   publish workflow only triggers on tags matching `v*`).
+5. Push the tag: `git push origin vX.Y.Z`.
+
+The workflow:
+- Verifies the tag's version matches `pyproject.toml`
+- Runs lint + typecheck + offline tests
+- Builds sdist + wheel via `uv build`
+- Publishes to PyPI through the OIDC trusted publisher
+
+If the tag-vs-pyproject guard fails, fix `pyproject.toml`, retag with
+`git tag -d` + recreate, and re-push.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

options_analysis_suite-0.1.0a1/pyproject.toml

@@ -0,0 +1,100 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "options-analysis-suite"
+version = "0.1.0a1"
+description = "Python SDK for the Options Analysis Suite API: 17 pricing models, auto-calibration, GEX/DEX exposure, IV surfaces, and pre-computed market data."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Options Analysis Suite" }]
+keywords = ["options", "trading", "quant", "greeks", "exposure", "calibration", "heston", "sabr"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Financial and Insurance Industry",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Office/Business :: Financial :: Investment",
+]
+# Note: no Typing :: Typed classifier and no `py.typed` marker until the
+# datamodel-codegen output is mypy-clean. The hand-written surface
+# (client.py, errors.py, credentials.py, _transport.py) is fully typed and
+# passes `mypy --strict`; the generated module is excluded.
+dependencies = [
+  "httpx>=0.27,<1.0",
+  "pydantic>=2.5,<3.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=7.4",
+  "respx>=0.20",
+  "ruff>=0.5",
+  "mypy>=1.8",
+  "twine>=5.0",
+]
+codegen = [
+  "datamodel-code-generator>=0.26",
+]
+
+[project.urls]
+Homepage = "https://optionsanalysissuite.com"
+Documentation = "https://data.optionsanalysissuite.com/docs"
+Repository = "https://github.com/Options-Analysis-Suite/options-analysis-suite-python"
+Changelog = "https://github.com/Options-Analysis-Suite/options-analysis-suite-python/blob/main/CHANGELOG.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/oas"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/oas",
+  "tests",
+  "scripts",
+  "README.md",
+  "CHANGELOG.md",
+  "LICENSE",
+  "Makefile",
+  "pyproject.toml",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+# Generated models are not hand-written; lint them only via the codegen script's
+# post-processing — not by hand-editing the file.
+extend-exclude = ["src/oas/_generated"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP", "N"]
+
+[tool.ruff.lint.per-file-ignores]
+# Pricing-convention argument names: S=spot, K=strike, etc. Allowed everywhere
+# the math actually demands them; renaming to lowercase would obscure the
+# Black-Scholes correspondence.
+"src/oas/client.py" = ["N803"]
+"src/oas/calibration.py" = ["N803"]
+# _manifest.py is a hand-aligned table mapping operationIds → Endpoint(...)
+# entries. The visual alignment is more valuable than a 100-char wrap.
+"src/oas/_manifest.py" = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+  "live: integration tests that hit the deployed API (require OAS_API_KEY env var)",
+]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+files = ["src/oas"]
+# datamodel-codegen output uses old-style `confloat(...)` / `constr(...)` annotations
+# that mypy doesn't accept as type expressions even though Pydantic handles them at
+# runtime. The generated file is mechanically produced, so don't gate dev on it.
+exclude = ["src/oas/_generated/.*"]