orrery-client 0.1.0

Read-only Python client for the Orrery x402 prediction-market intelligence API.

orrery-client

Dependency-light Python client for the Orrery x402 prediction-market intelligence API.

The client calls Orrery only. It does not connect to Polymarket or Kalshi accounts, submit orders, read positions, or provide trade recommendations.

from orrery import OrreryClient, OrreryPaymentRequired

client = OrreryClient(
    api_key="orrery_live_...",
    payment="...",
)

try:
    queue = client.attention(limit=5)
    print(queue["data"])
except OrreryPaymentRequired as exc:
    print(exc.challenge)

api_key spends monthly Orrery API credits first. payment is the x402 fallback for per-call settlement when credits are unavailable or exhausted. When omitted, the client reads ORRERY_BASE_URL, ORRERY_API_KEY, and ORRERY_X_PAYMENT from the environment.

Covered helpers:

• health / venues / brief
• search / markets / movers / events / event cluster
• attention queue / market Decision Card
• market snapshot / why / resolution risk
• signals / signal-kind drilldown / backtest
• category intelligence / trades / wallet profile / share card
• watchlist summary / portfolio risk

Local verification:

python -m pip install -e .
python -m unittest discover -s tests