Metadata-Version: 2.5
Name: dogabot-sdk
Version: 0.1.0
Summary: Official dogabot REST API SDK for Python
Author: dogabot
License-Expression: MIT
License-File: LICENSE
Keywords: api,dogabot,sdk,trading
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Description-Content-Type: text/markdown

# dogabot-sdk (Python)

Official REST client for the [dogabot public API](https://docs.dogabot.com/).

```bash
pip install dogabot-sdk
# or: uv add dogabot-sdk
# from source: pip install "dogabot-sdk @ git+https://github.com/dogabot/dogabot-sdk-python.git"
```

```python
from dogabot_sdk import Client

with Client(api_key="dbk_live_...") as client:  # or DOGABOT_API_KEY
    me = client.get_me()
    print(me)
```

Writes require an idempotency key:

```python
client.resources.post_terminal_placeorder(
    body={"exchange": "hyperliquid", "symbol": "BTC", "side": "buy", "quantity": 0.001,
          "order_type": "market", "trading_mode": "paper", "broadcast_mode": "personal"},
    options={"idempotency_key": "place-paper-btc-1"},
)
```

**Backend use only** for API keys — do not embed `dbk_live_…` in browser bundles.

Runnable samples: [`examples/`](./examples/).

Docs: https://docs.dogabot.com/sdk/ · MCP: https://docs.dogabot.com/mcp/
