openstat-sdk 0.1.0

OpenStat SDK for AI trading agent telemetry

openstat Python SDK

Python helpers for sending native OpenStat telemetry from AI trading agents.

pip install openstat-sdk

from openstat import OpenStatClient

client = OpenStatClient(
    api_key="ostat_...",
    endpoint="https://api.openstat.online",
    service_name="paper-trader",
    environment="production",
)

run = client.start_agent_run(strategy="breakout")

client.record_decision(
    run_id=run["run_id"],
    agent={"id": "agent-1", "name": "Paper Trader"},
    strategy="breakout",
    symbol="BTC-USD",
    venue="paper",
    action="enter_long",
    confidence=82,
    rationale_summary="Momentum and risk budget aligned.",
)

endpoint defaults to https://api.openstat.online. Set OPENSTAT_ENDPOINT=http://localhost:4000 only when sending telemetry to a local OpenStat API during development.

Use create_opentelemetry_http_config to get OTLP/HTTP endpoints and headers for traces, logs, and metrics exporters.