Python

import requests


class PlatformClient:
    """Thin wrapper over the local HTTP API. Not a published
    package -- copy this into your project, or call requests directly."""

    def __init__(self, base_url: str = "http://127.0.0.1:8777", api_key: str | None = None):
        self.base_url = base_url.rstrip("/")
        self._session = requests.Session()
        if api_key:
            # Only relevant for the keyed Enterprise Wallet API -- the local
            # dashboard endpoints below take no key by default.
            self._session.headers["X-API-Key"] = api_key

    def edge(self, tier: str = "pro") -> dict:
        r = self._session.get(f"{self.base_url}/edge.json", params={"tier": tier})
        r.raise_for_status()
        return r.json()

    def risk(self) -> dict:
        r = self._session.get(f"{self.base_url}/risk.json")
        r.raise_for_status()
        return r.json()

    def ledger(self) -> dict:
        r = self._session.get(f"{self.base_url}/edge/ledger.json")
        r.raise_for_status()
        return r.json()

    def enterprise_wallets(self, limit: int = 100, copyable_only: bool = False) -> dict:
        r = self._session.get(
            f"{self.base_url}/api/enterprise/wallets/top",
            params={"limit": limit, "copyable_only": copyable_only},
        )
        r.raise_for_status()
        return r.json()


client = PlatformClient()
signals = client.edge()["signals"]
for s in signals:
    print(s["pair"], s["direction"], s["conviction"])

import requests

resp = requests.get(
    "http://127.0.0.1:8777/edge/backtest.json",
    params={"kinds": "funding,liq", "pair": "BTC", "min_conviction": 60, "days": 90},
)
result = resp.json()
if result.get("biased"):
    print("warning: filtered below the live conviction bar -- result understates selectivity")