Metadata-Version: 2.4
Name: orrery-client
Version: 0.1.0
Summary: Read-only Python client for the Orrery x402 prediction-market intelligence API.
Author-email: Orrery <hello@orrery.me>
License-Expression: MIT
Project-URL: Homepage, https://orrery.me
Project-URL: Documentation, https://orrery.me/docs/agents/sdk
Project-URL: Repository, https://github.com/bez111/orrery
Project-URL: Issues, https://github.com/bez111/orrery/issues
Keywords: orrery,x402,prediction-markets,polymarket,kalshi,agents
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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 :: Internet :: WWW/HTTP
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# 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.

```python
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:

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