quantjourney-api 0.1.1__tar.gz

quantjourney_api-0.1.1/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: quantjourney-api
+Version: 0.1.1
+Summary: Python SDK for QuantJourney qj-api product contracts.
+Author: QuantJourney
+License-Expression: LicenseRef-Proprietary
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: quantjourney-common-sdk<0.2,>=0.1.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Provides-Extra: frames
+Requires-Dist: pandas>=2.0.0; extra == "frames"
+
+# quantjourney-api
+
+Python SDK for the public/product `qj-api` contract.
+
+Canonical package metadata:
+
+| Field | Value |
+| --- | --- |
+| Repository | `_repo_qj_api_sdk` |
+| Distribution | `quantjourney-api` |
+| Python import | `qj.api` |
+| Runtime client | `QJ` |
+| Backend boundary | `qj-api` / `https://api.quantjourney.cloud` |
+| Version | `0.1.1` |
+| Git tag | `api-v0.1.1` |
+
+`quantjourney-api` is the public product/API SDK. The `quantjourney` umbrella
+package lives in `packages/quantjourney` and installs `quantjourney-api`.
+
+```python
+from qj.api import QJ, QuantJourneyAPI
+
+qj = QJ.from_env()
+health = qj.health()
+capabilities = qj.capabilities()
+
+# Provider connectors through qj-api
+profile = qj.fmp.get_company_profile(symbol="NVDA")
+gdp = qj.fred.get_series(series_id="GDP")
+filings = qj.sec.get_recent_filings(limit=5)
+
+# Provider-agnostic domain routes
+routes = qj.domains.list()
+prices = qj.domains.equity.pricing.get_historical_prices(symbol="NVDA")
+
+# Product API surfaces
+analytics = qj.analytics.registry()
+ratios = qj.ratios.available(source="eod")
+indicators = qj.technical.available()
+
+# Compatibility aliases
+qj2 = QuantJourneyAPI.from_env()
+```
+
+Local smoke from this checkout:
+
+```bash
+python scripts/qj_api_smoke.py --env .env
+python scripts/endpoint_matrix.py --env .env
+python scripts/endpoint_matrix.py --env .env --list
+python scripts/endpoint_matrix.py --env .env --group connectors --allow-failures
+python scripts/endpoint_matrix.py --env .env --group connector_examples --include-connector-examples --allow-failures
+python scripts/connector_matrix.py --env .env
+```
+
+`scripts/connectors.json` stores one smoke example per connector. The endpoint
+matrix verifies every connector route; `connector_matrix.py` runs the examples
+and prints a compact result table.
+
+Environment variables:
+
+| Variable | Purpose |
+| --- | --- |
+| `QJ_API_URL` | qj-api base URL, default `https://api.quantjourney.cloud` |
+| `QJ_API_TOKEN` | bearer token |
+| `QJ_AUTH_URL` | qj-auth base URL for token exchange |
+| `QJ_API_KEY` | `QJ_live_*` API key used to mint `QJ_API_TOKEN` |
+| `QJ_API_CLIENT_ID` | service account client id for `client_credentials` |
+| `QJ_API_CLIENT_SECRET` | `QJ_svc_*` service secret for `client_credentials` |
+| `QJ_API_TENANT_ID` | optional tenant projection |
+| `QJ_API_TEAM_ID` | optional team projection |
+
+Install from PyPI:
+
+```bash
+pip install quantjourney-api==0.1.1
+```
+
+`quantjourney-common-sdk` is installed automatically as a dependency. Local
+development can still use editable path installs for sibling checkouts.
+
+The new surface keeps the smaller `qj.api` namespace, uses
+`quantjourney-common-sdk` for
+auth/transport, exposes dynamic qj-api connector clients, and keeps warehouse
+data-plane concerns in `quantjourney-data`.

quantjourney_api-0.1.1/README.md

@@ -0,0 +1,85 @@
+# quantjourney-api
+
+Python SDK for the public/product `qj-api` contract.
+
+Canonical package metadata:
+
+| Field | Value |
+| --- | --- |
+| Repository | `_repo_qj_api_sdk` |
+| Distribution | `quantjourney-api` |
+| Python import | `qj.api` |
+| Runtime client | `QJ` |
+| Backend boundary | `qj-api` / `https://api.quantjourney.cloud` |
+| Version | `0.1.1` |
+| Git tag | `api-v0.1.1` |
+
+`quantjourney-api` is the public product/API SDK. The `quantjourney` umbrella
+package lives in `packages/quantjourney` and installs `quantjourney-api`.
+
+```python
+from qj.api import QJ, QuantJourneyAPI
+
+qj = QJ.from_env()
+health = qj.health()
+capabilities = qj.capabilities()
+
+# Provider connectors through qj-api
+profile = qj.fmp.get_company_profile(symbol="NVDA")
+gdp = qj.fred.get_series(series_id="GDP")
+filings = qj.sec.get_recent_filings(limit=5)
+
+# Provider-agnostic domain routes
+routes = qj.domains.list()
+prices = qj.domains.equity.pricing.get_historical_prices(symbol="NVDA")
+
+# Product API surfaces
+analytics = qj.analytics.registry()
+ratios = qj.ratios.available(source="eod")
+indicators = qj.technical.available()
+
+# Compatibility aliases
+qj2 = QuantJourneyAPI.from_env()
+```
+
+Local smoke from this checkout:
+
+```bash
+python scripts/qj_api_smoke.py --env .env
+python scripts/endpoint_matrix.py --env .env
+python scripts/endpoint_matrix.py --env .env --list
+python scripts/endpoint_matrix.py --env .env --group connectors --allow-failures
+python scripts/endpoint_matrix.py --env .env --group connector_examples --include-connector-examples --allow-failures
+python scripts/connector_matrix.py --env .env
+```
+
+`scripts/connectors.json` stores one smoke example per connector. The endpoint
+matrix verifies every connector route; `connector_matrix.py` runs the examples
+and prints a compact result table.
+
+Environment variables:
+
+| Variable | Purpose |
+| --- | --- |
+| `QJ_API_URL` | qj-api base URL, default `https://api.quantjourney.cloud` |
+| `QJ_API_TOKEN` | bearer token |
+| `QJ_AUTH_URL` | qj-auth base URL for token exchange |
+| `QJ_API_KEY` | `QJ_live_*` API key used to mint `QJ_API_TOKEN` |
+| `QJ_API_CLIENT_ID` | service account client id for `client_credentials` |
+| `QJ_API_CLIENT_SECRET` | `QJ_svc_*` service secret for `client_credentials` |
+| `QJ_API_TENANT_ID` | optional tenant projection |
+| `QJ_API_TEAM_ID` | optional team projection |
+
+Install from PyPI:
+
+```bash
+pip install quantjourney-api==0.1.1
+```
+
+`quantjourney-common-sdk` is installed automatically as a dependency. Local
+development can still use editable path installs for sibling checkouts.
+
+The new surface keeps the smaller `qj.api` namespace, uses
+`quantjourney-common-sdk` for
+auth/transport, exposes dynamic qj-api connector clients, and keeps warehouse
+data-plane concerns in `quantjourney-data`.

quantjourney_api-0.1.1/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "quantjourney-api"
+version = "0.1.1"
+description = "Python SDK for QuantJourney qj-api product contracts."
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "QuantJourney" }]
+license = "LicenseRef-Proprietary"
+dependencies = [
+  "quantjourney-common-sdk>=0.1.1,<0.2",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0.0",
+]
+frames = [
+  "pandas>=2.0.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["qj.*"]
+namespaces = true
+
+[tool.pytest.ini_options]
+testpaths = ["_tests"]

quantjourney_api-0.1.1/qj/api/__init__.py

@@ -0,0 +1,14 @@
+"""qj.api public/product API SDK."""
+
+from .client import QJ, QuantJourney, QuantJourneyAPI
+from .resources import CONNECTORS, ConnectorClient, DomainsClient, DomainProxy
+
+__all__ = [
+    "CONNECTORS",
+    "ConnectorClient",
+    "DomainsClient",
+    "DomainProxy",
+    "QJ",
+    "QuantJourney",
+    "QuantJourneyAPI",
+]

quantjourney_api-0.1.1/qj/api/client.py

@@ -0,0 +1,137 @@
+"""qj-api product SDK client surface."""
+
+from __future__ import annotations
+
+import os
+from collections.abc import Mapping
+from typing import Any
+
+from qj.common import AuthConfig, HttpClient, QJResponse
+
+from .resources import (
+    CONNECTORS,
+    AnalyticsClient,
+    AuthClient,
+    BacktesterClient,
+    ConnectorClient,
+    DomainsClient,
+    InsiderClient,
+    RatiosClient,
+    TechnicalClient,
+    UniverseClient,
+)
+
+DEFAULT_API_URL = "https://api.quantjourney.cloud"
+
+
+class QJ:
+    """Runtime client for qj-api product contracts."""
+
+    def __init__(
+        self,
+        *,
+        base_url: str = DEFAULT_API_URL,
+        token: str | None = None,
+        api_key: str | None = None,
+        auth_url: str | None = None,
+        client_id: str | None = None,
+        client_secret: str | None = None,
+        tenant_id: str | None = None,
+        team_id: str | None = None,
+        timeout: float = 30.0,
+        http_client: HttpClient | None = None,
+    ) -> None:
+        auth = AuthConfig(
+            bearer_token=token,
+            api_key=api_key,
+            client_id=client_id,
+            client_secret=client_secret,
+            auth_url=auth_url or "https://auth.quantjourney.cloud",
+            tenant_id=tenant_id,
+            team_id=team_id,
+        )
+        self.http = http_client or HttpClient(
+            base_url,
+            auth=auth,
+            timeout=timeout,
+            user_agent="qj.api/0.1.0",
+        )
+        self._refresh_token: str | None = None
+        self.auth = AuthClient(self)
+        self.domains = DomainsClient(self)
+        self.analytics = AnalyticsClient(self)
+        self.bt = BacktesterClient(self)
+        self.backtester = self.bt
+        self.universe = UniverseClient(self)
+        self.ratios = RatiosClient(self)
+        self.technical = TechnicalClient(self)
+        self.insider = InsiderClient(self)
+        self._connectors: dict[str, ConnectorClient] = {
+            connector: ConnectorClient(self, connector) for connector in CONNECTORS
+        }
+        for connector, client in self._connectors.items():
+            setattr(self, connector, client)
+
+    @classmethod
+    def from_env(cls) -> "QJ":
+        auth = AuthConfig.from_env("QJ_API")
+        return cls(
+            base_url=os.getenv("QJ_API_URL") or os.getenv("QJ_API_BASE_URL") or DEFAULT_API_URL,
+            token=auth.bearer_token,
+            api_key=auth.api_key,
+            auth_url=auth.auth_url,
+            client_id=auth.client_id,
+            client_secret=auth.client_secret,
+            tenant_id=auth.tenant_id,
+            team_id=auth.team_id,
+            timeout=float(os.getenv("QJ_API_TIMEOUT", "30")),
+        )
+
+    def health(self) -> QJResponse:
+        return self.http.get("/health")
+
+    def contract_version(self) -> QJResponse:
+        return self.http.get("/api/v1/contract")
+
+    def capabilities(self) -> QJResponse:
+        return self.http.get("/api/v1/capabilities")
+
+    def upstreams(self) -> QJResponse:
+        return self.http.get("/api/v1/upstreams")
+
+    def get(self, path: str, **params: Any) -> QJResponse:
+        return self.http.get(path, params=_clean(params))
+
+    def post(self, path: str, json: Mapping[str, Any] | None = None) -> QJResponse:
+        return self.http.post(path, json=json)
+
+    def connector(self, name: str) -> ConnectorClient:
+        key = name.strip().lower().replace("-", "_")
+        if key not in self._connectors:
+            self._connectors[key] = ConnectorClient(self, key)
+        return self._connectors[key]
+
+    def domain(self, route_prefix: str):
+        proxy = self.domains
+        for part in route_prefix.split("."):
+            if part:
+                proxy = getattr(proxy, part)
+        return proxy
+
+    def __getattr__(self, name: str):
+        if name.startswith("_"):
+            raise AttributeError(name)
+        if name in CONNECTORS:
+            return self.connector(name)
+        return self.domain(name)
+
+
+def _clean(params: Mapping[str, Any] | None) -> dict[str, Any] | None:
+    if not params:
+        return None
+    cleaned = {key: value for key, value in params.items() if value is not None}
+    return cleaned or None
+
+
+QuantJourneyAPI = QJ
+QuantJourney = QJ

quantjourney_api-0.1.1/qj/api/py.typed

@@ -0,0 +1 @@
+

quantjourney_api-0.1.1/qj/api/resources.py

@@ -0,0 +1,432 @@
+"""Resource clients for the qj-api SDK surface."""
+
+from __future__ import annotations
+
+from collections.abc import Mapping, Sequence
+from typing import Any
+
+import requests
+
+from qj.common import QJResponse
+
+
+CONNECTORS: tuple[str, ...] = (
+    "bea",
+    "bis",
+    "bls",
+    "boc",
+    "cboe",
+    "ccxt",
+    "census",
+    "cftc",
+    "cnnf",
+    "coingecko",
+    "dbnomics",
+    "defillama",
+    "ecb",
+    "eia",
+    "eod",
+    "esma",
+    "eurostat",
+    "fdic",
+    "ff",
+    "finnhub",
+    "finra",
+    "fmp",
+    "fred",
+    "gdelt",
+    "gleif",
+    "hud",
+    "imf",
+    "kalshi",
+    "multpl",
+    "nasdaqtrader",
+    "nyfed",
+    "oecd",
+    "ofac",
+    "ofr",
+    "openfigi",
+    "polymarket",
+    "rba",
+    "reddit",
+    "sec",
+    "secadv",
+    "secftd",
+    "snb",
+    "stocktwits",
+    "stooq",
+    "tiingo",
+    "treasury",
+    "usda",
+    "worldbank",
+    "yf",
+)
+
+
+class _Resource:
+    def __init__(self, qj: Any) -> None:
+        self._qj = qj
+
+    def _get(self, path: str, **params: Any) -> QJResponse:
+        return self._qj.http.get(path, params=_clean(params))
+
+    def _post(self, path: str, json: Mapping[str, Any] | None = None, **params: Any) -> QJResponse:
+        return self._qj.http.post(path, json=_clean_body(json), params=_clean(params))
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: Mapping[str, Any] | None = None,
+        json: Mapping[str, Any] | None = None,
+    ) -> QJResponse:
+        if hasattr(self._qj.http, "request"):
+            return self._qj.http.request(method, path, params=_clean(params), json=_clean_body(json))
+        method = method.upper()
+        if method == "GET":
+            return self._qj.http.get(path, params=_clean(params))
+        if method == "POST":
+            return self._qj.http.post(path, json=_clean_body(json))
+        raise AttributeError("Configured http_client does not expose request().")
+
+
+class ConnectorClient(_Resource):
+    """Dynamic client for qj-api provider connector routes.
+
+    Examples:
+        qj.fmp.get_company_profile(symbol="NVDA")
+        qj.fred.get_series(series_id="GDP")
+        qj.yf.get_historical_prices(symbol="AAPL")
+    """
+
+    def __init__(self, qj: Any, connector: str) -> None:
+        super().__init__(qj)
+        self.connector = connector
+
+    def call(self, method: str, **params: Any) -> QJResponse:
+        return self._post(f"/{self.connector}/{method}", _normalize_connector_payload(self.connector, method, params))
+
+    def __getattr__(self, method: str):
+        if method.startswith("_"):
+            raise AttributeError(method)
+
+        def _call(**params: Any) -> QJResponse:
+            return self.call(method, **params)
+
+        _call.__name__ = method
+        _call.__doc__ = f"POST /{self.connector}/{method}"
+        return _call
+
+    def __repr__(self) -> str:
+        return f"ConnectorClient({self.connector!r})"
+
+
+class DomainProxy:
+    """Chainable proxy for qj-api `/d/<domain.route>` calls."""
+
+    def __init__(self, domains: "DomainsClient", path: str) -> None:
+        self._domains = domains
+        self._path = path
+
+    def __getattr__(self, name: str):
+        if name.startswith("_"):
+            raise AttributeError(name)
+        if _looks_like_callable_domain_method(name):
+            route = f"{self._path}.{name}"
+
+            def _call(**payload: Any) -> QJResponse:
+                return self._domains.call(route, **payload)
+
+            _call.__name__ = name
+            _call.__doc__ = f"POST /d/{route}"
+            return _call
+        return DomainProxy(self._domains, f"{self._path}.{name}")
+
+    def __repr__(self) -> str:
+        return f"DomainProxy({self._path!r})"
+
+
+class DomainsClient(_Resource):
+    """Discovery and invocation client for qj-api domain routes."""
+
+    def list(self) -> QJResponse:
+        return self._get("/d/")
+
+    def tree(
+        self,
+        *,
+        scope: str = "all",
+        include_aliases: bool = True,
+        include_unavailable: bool = True,
+    ) -> QJResponse:
+        return self._get(
+            "/d/tree",
+            scope=scope,
+            include_aliases=_bool(include_aliases),
+            include_unavailable=_bool(include_unavailable),
+        )
+
+    def aliases(self) -> QJResponse:
+        return self._get("/d/aliases")
+
+    def synonyms(self) -> QJResponse:
+        return self._get("/d/synonyms")
+
+    def describe(self, route: str) -> QJResponse:
+        return self._get(f"/d/describe/{route}")
+
+    def call(self, route: str, **payload: Any) -> QJResponse:
+        return self._post(f"/d/{route}", payload)
+
+    def __getattr__(self, name: str):
+        if name.startswith("_"):
+            raise AttributeError(name)
+        return DomainProxy(self, name)
+
+
+class AuthClient(_Resource):
+    """qj-auth helpers that wire successful login into the SDK client."""
+
+    def login(self, email: str, password: str, *, tenant_id: str | None = None) -> Mapping[str, Any]:
+        payload: dict[str, Any] = {"email": email, "password": password}
+        if tenant_id:
+            payload["tenant_id"] = tenant_id
+        body = self._auth_request("POST", "/auth/login", json=payload)
+        token = body.get("access_token") if isinstance(body, dict) else None
+        if token:
+            self._qj.http.auth.bearer_token = str(token)
+            self._qj.http.auth.invalidate()
+        refresh = body.get("refresh_token") if isinstance(body, dict) else None
+        if refresh:
+            self._qj._refresh_token = str(refresh)
+        return body
+
+    def refresh(self) -> Mapping[str, Any]:
+        refresh_token = getattr(self._qj, "_refresh_token", None)
+        if not refresh_token:
+            raise RuntimeError("No refresh token available. Call auth.login() first.")
+        body = self._auth_request("POST", "/auth/refresh", json={"refresh_token": refresh_token})
+        token = body.get("access_token") if isinstance(body, dict) else None
+        if token:
+            self._qj.http.auth.bearer_token = str(token)
+            self._qj.http.auth.invalidate()
+        refresh = body.get("refresh_token") if isinstance(body, dict) else None
+        if refresh:
+            self._qj._refresh_token = str(refresh)
+        return body
+
+    def whoami(self) -> Mapping[str, Any]:
+        return self._auth_request("GET", "/auth/whoami")
+
+    def _auth_request(self, method: str, path: str, *, json: Mapping[str, Any] | None = None) -> Mapping[str, Any]:
+        headers: dict[str, str] = {"Accept": "application/json"}
+        token = self._qj.http.auth.token()
+        if token:
+            headers["Authorization"] = f"Bearer {token}"
+        url = f"{self._qj.http.auth.auth_url.rstrip('/')}/{path.lstrip('/')}"
+        response = requests.request(method, url, json=json, headers=headers, timeout=self._qj.http.timeout)
+        body = response.json() if response.text else {}
+        response.raise_for_status()
+        return body
+
+
+class AnalyticsClient(_Resource):
+    def info(self) -> QJResponse:
+        return self._get("/analytics/")
+
+    def registry(self) -> QJResponse:
+        return self._get("/analytics/registry")
+
+    def hv(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/hv", payload)
+
+    def hv_plot(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/hv_plot", payload)
+
+    def iv(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/iv", payload)
+
+    def iv_plot(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/iv_plot", payload)
+
+    def greeks(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/greeks", payload)
+
+    def greeks_plot(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/greeks_plot", payload)
+
+    def rolling_plot(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/rolling_plot", payload)
+
+    def beta_plot(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/beta_plot", payload)
+
+    def iv_surface_plot(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/iv_surface_plot", payload)
+
+    def factors_beta(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/factors_beta", payload)
+
+    def factors_beta_plot(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/factors_beta_plot", payload)
+
+    def job(self, job_id: str) -> QJResponse:
+        return self._get(f"/analytics/jobs/{job_id}")
+
+    def create_job(self, **payload: Any) -> QJResponse:
+        return self._post("/analytics/jobs", payload)
+
+
+class BacktesterClient(_Resource):
+    def info(self) -> QJResponse:
+        return self._get("/bt/")
+
+    def prepare(self, **payload: Any) -> QJResponse:
+        return self._post("/bt/prepare", payload)
+
+    def plots(self, **payload: Any) -> QJResponse:
+        return self._post("/bt/plots", payload)
+
+    def sessions(self) -> QJResponse:
+        return self._get("/bt/sessions")
+
+    def session(self, session_id: str) -> QJResponse:
+        return self._get(f"/bt/sessions/{session_id}")
+
+    def datasets(self) -> QJResponse:
+        return self._get("/bt/datasets")
+
+    def dataset(self, dataset_id: str) -> QJResponse:
+        return self._get(f"/bt/datasets/{dataset_id}")
+
+    def calc_registry(self) -> QJResponse:
+        return self._get("/bt/calc/registry")
+
+    def calc_portfolio(self, **payload: Any) -> QJResponse:
+        return self._post("/bt/calc/portfolio", payload)
+
+    def calc_instrument(self, **payload: Any) -> QJResponse:
+        return self._post("/bt/calc/instrument", payload)
+
+
+class UniverseClient(_Resource):
+    def info(self) -> QJResponse:
+        return self._get("/universe/")
+
+    def preview(self, spec: Mapping[str, Any] | None = None, *, offset: int = 0, limit: int = 100) -> QJResponse:
+        return self._post("/universe/preview", spec or {}, offset=offset, limit=limit)
+
+    def build(self, spec: Mapping[str, Any] | None = None) -> QJResponse:
+        return self._post("/universe/build", spec or {})
+
+    def list(self, *, offset: int = 0, limit: int = 100) -> QJResponse:
+        return self._get("/universe/list", offset=offset, limit=limit)
+
+    def get(self, universe_id: str) -> QJResponse:
+        return self._get(f"/universe/{universe_id}")
+
+
+class RatiosClient(_Resource):
+    def available(self, *, source: str = "eod") -> QJResponse:
+        return self._get("/ratios/available", source=source)
+
+    def series(
+        self,
+        ratio: str,
+        ticker: str,
+        *,
+        exchange: str = "US",
+        source: str = "eod",
+        start: str | None = None,
+        end: str | None = None,
+        compute: bool = False,
+        period: str = "q",
+        years: int | None = None,
+        pub_lag_days: int | None = None,
+        calendar_code: str | None = None,
+    ) -> QJResponse:
+        return self._get(
+            "/ratios/series",
+            ratio=ratio,
+            ticker=ticker,
+            exchange=exchange,
+            source=source,
+            start=start,
+            end=end,
+            compute=compute,
+            period=period,
+            years=years,
+            pub_lag_days=pub_lag_days,
+            calendar_code=calendar_code,
+        )
+
+
+class TechnicalClient(_Resource):
+    def available(self) -> QJResponse:
+        return self._get("/technical/available")
+
+    def series(self, indicator: str, ticker: str, **payload: Any) -> QJResponse:
+        body = {"indicator": indicator, "ticker": ticker, **payload}
+        return self._post("/technical/series", body)
+
+
+class InsiderClient(_Resource):
+    def info(self) -> QJResponse:
+        return self._get("/insider/")
+
+    def scan(self, symbols: Sequence[str], **payload: Any) -> QJResponse:
+        return self._post("/insider/scan", {"symbols": list(symbols), **payload})
+
+    def new(self, symbols: Sequence[str] | None = None, **payload: Any) -> QJResponse:
+        body = {"symbols": list(symbols) if symbols is not None else [], **payload}
+        return self._post("/insider/new", body)
+
+    def summary(self, symbols: Sequence[str], **payload: Any) -> QJResponse:
+        return self._post("/insider/summary", {"symbols": list(symbols), **payload})
+
+    def latest_trades(self, symbols: Sequence[str], **payload: Any) -> QJResponse:
+        return self._post("/insider/latest_trades", {"symbols": list(symbols), **payload})
+
+    def summary_universe(self, **payload: Any) -> QJResponse:
+        return self._post("/insider/summary_universe", payload)
+
+
+def _normalize_connector_payload(connector: str, method: str, params: Mapping[str, Any]) -> dict[str, Any] | None:
+    payload = dict(params)
+    if connector in {"eod", "fmp", "yf"} and method in {
+        "get_historical_prices",
+        "get_intraday_prices",
+        "get_real_time_prices",
+        "get_forex_intraday_prices",
+    }:
+        if "symbols" not in payload and "symbol" in payload:
+            symbol = payload.pop("symbol")
+            if isinstance(symbol, str) and "," in symbol:
+                payload["symbols"] = [item.strip() for item in symbol.split(",") if item.strip()]
+            else:
+                payload["symbols"] = [symbol] if isinstance(symbol, str) else symbol
+    # FastAPI connector methods expect a JSON object body even when the
+    # parameter model has no required fields.
+    return {key: value for key, value in payload.items() if value is not None}
+
+
+def _looks_like_callable_domain_method(name: str) -> bool:
+    return name.startswith(("get_", "list_", "search_", "fetch_", "query_", "calculate_", "compute_"))
+
+
+def _bool(value: bool) -> str:
+    return "true" if value else "false"
+
+
+def _clean(params: Mapping[str, Any] | None) -> dict[str, Any] | None:
+    if not params:
+        return None
+    cleaned = {key: value for key, value in params.items() if value is not None}
+    return cleaned or None
+
+
+def _clean_body(params: Mapping[str, Any] | None) -> dict[str, Any] | None:
+    if params is None:
+        return None
+    return {key: value for key, value in params.items() if value is not None}

quantjourney_api-0.1.1/qj/sdk/__init__.py

@@ -0,0 +1,14 @@
+"""Compatibility alias for the canonical :mod:`qj.api` package."""
+
+from qj.api import QJ, QuantJourney, QuantJourneyAPI
+from qj.api.resources import CONNECTORS, ConnectorClient, DomainsClient, DomainProxy
+
+__all__ = [
+    "CONNECTORS",
+    "ConnectorClient",
+    "DomainsClient",
+    "DomainProxy",
+    "QJ",
+    "QuantJourney",
+    "QuantJourneyAPI",
+]

quantjourney_api-0.1.1/qj/sdk/client.py

@@ -0,0 +1,3 @@
+"""Compatibility alias for :mod:`qj.api.client`."""
+
+from qj.api.client import *  # noqa: F401,F403

quantjourney_api-0.1.1/qj/sdk/py.typed

@@ -0,0 +1 @@
+

quantjourney_api-0.1.1/qj/sdk/resources.py

@@ -0,0 +1,3 @@
+"""Compatibility alias for :mod:`qj.api.resources`."""
+
+from qj.api.resources import *  # noqa: F401,F403

quantjourney_api-0.1.1/quantjourney_api.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: quantjourney-api
+Version: 0.1.1
+Summary: Python SDK for QuantJourney qj-api product contracts.
+Author: QuantJourney
+License-Expression: LicenseRef-Proprietary
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: quantjourney-common-sdk<0.2,>=0.1.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Provides-Extra: frames
+Requires-Dist: pandas>=2.0.0; extra == "frames"
+
+# quantjourney-api
+
+Python SDK for the public/product `qj-api` contract.
+
+Canonical package metadata:
+
+| Field | Value |
+| --- | --- |
+| Repository | `_repo_qj_api_sdk` |
+| Distribution | `quantjourney-api` |
+| Python import | `qj.api` |
+| Runtime client | `QJ` |
+| Backend boundary | `qj-api` / `https://api.quantjourney.cloud` |
+| Version | `0.1.1` |
+| Git tag | `api-v0.1.1` |
+
+`quantjourney-api` is the public product/API SDK. The `quantjourney` umbrella
+package lives in `packages/quantjourney` and installs `quantjourney-api`.
+
+```python
+from qj.api import QJ, QuantJourneyAPI
+
+qj = QJ.from_env()
+health = qj.health()
+capabilities = qj.capabilities()
+
+# Provider connectors through qj-api
+profile = qj.fmp.get_company_profile(symbol="NVDA")
+gdp = qj.fred.get_series(series_id="GDP")
+filings = qj.sec.get_recent_filings(limit=5)
+
+# Provider-agnostic domain routes
+routes = qj.domains.list()
+prices = qj.domains.equity.pricing.get_historical_prices(symbol="NVDA")
+
+# Product API surfaces
+analytics = qj.analytics.registry()
+ratios = qj.ratios.available(source="eod")
+indicators = qj.technical.available()
+
+# Compatibility aliases
+qj2 = QuantJourneyAPI.from_env()
+```
+
+Local smoke from this checkout:
+
+```bash
+python scripts/qj_api_smoke.py --env .env
+python scripts/endpoint_matrix.py --env .env
+python scripts/endpoint_matrix.py --env .env --list
+python scripts/endpoint_matrix.py --env .env --group connectors --allow-failures
+python scripts/endpoint_matrix.py --env .env --group connector_examples --include-connector-examples --allow-failures
+python scripts/connector_matrix.py --env .env
+```
+
+`scripts/connectors.json` stores one smoke example per connector. The endpoint
+matrix verifies every connector route; `connector_matrix.py` runs the examples
+and prints a compact result table.
+
+Environment variables:
+
+| Variable | Purpose |
+| --- | --- |
+| `QJ_API_URL` | qj-api base URL, default `https://api.quantjourney.cloud` |
+| `QJ_API_TOKEN` | bearer token |
+| `QJ_AUTH_URL` | qj-auth base URL for token exchange |
+| `QJ_API_KEY` | `QJ_live_*` API key used to mint `QJ_API_TOKEN` |
+| `QJ_API_CLIENT_ID` | service account client id for `client_credentials` |
+| `QJ_API_CLIENT_SECRET` | `QJ_svc_*` service secret for `client_credentials` |
+| `QJ_API_TENANT_ID` | optional tenant projection |
+| `QJ_API_TEAM_ID` | optional team projection |
+
+Install from PyPI:
+
+```bash
+pip install quantjourney-api==0.1.1
+```
+
+`quantjourney-common-sdk` is installed automatically as a dependency. Local
+development can still use editable path installs for sibling checkouts.
+
+The new surface keeps the smaller `qj.api` namespace, uses
+`quantjourney-common-sdk` for
+auth/transport, exposes dynamic qj-api connector clients, and keeps warehouse
+data-plane concerns in `quantjourney-data`.

quantjourney_api-0.1.1/quantjourney_api.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+README.md
+pyproject.toml
+qj/api/__init__.py
+qj/api/client.py
+qj/api/py.typed
+qj/api/resources.py
+qj/sdk/__init__.py
+qj/sdk/client.py
+qj/sdk/py.typed
+qj/sdk/resources.py
+quantjourney_api.egg-info/PKG-INFO
+quantjourney_api.egg-info/SOURCES.txt
+quantjourney_api.egg-info/dependency_links.txt
+quantjourney_api.egg-info/requires.txt
+quantjourney_api.egg-info/top_level.txt

quantjourney_api-0.1.1/quantjourney_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

quantjourney_api-0.1.1/quantjourney_api.egg-info/requires.txt

@@ -0,0 +1,7 @@
+quantjourney-common-sdk<0.2,>=0.1.1
+
+[dev]
+pytest>=8.0.0
+
+[frames]
+pandas>=2.0.0

quantjourney_api-0.1.1/quantjourney_api.egg-info/top_level.txt

@@ -0,0 +1 @@
+qj

quantjourney_api-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+