Metadata-Version: 2.4
Name: kingpulse-sdk
Version: 1.0.1
Summary: Official Python client for the KingPulse Developer API
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# kingpulse-sdk

Official, dependency-free Python client for the KingPulse Developer API.

Install from PyPI:

```bash
python3 -m pip install kingpulse-sdk
```

```python
import os
from kingpulse_sdk import KingPulseClient

client = KingPulseClient(api_key=os.environ["KINGPULSE_API_KEY"])
markets = client.list_markets(q="KING", limit=10)
created = client.create_paper_bot({
    "name": "EMA hourly",
    "strategy": "ema",
    "marketAddress": "0x1111111111111111111111111111111111111111",
    "interval": "1h",
    "initialQuote": "10000",
})
print(markets, created["bot"]["id"])
```

Methods: `list_markets`, `get_market`, `list_tokens`, `list_swaps`, `list_candles`, `list_liquidity`, `get_stats`, `list_paper_bots`, `create_paper_bot`, and `delete_paper_bot`.

## Safety

- Keep the key in a server-side environment variable or secret manager; do not put it in a browser, public app, or source control.
- Bot API calls create **inactive paper profiles only**. They do not execute strategies, sign transactions, or place live trades.
- Catch `KingPulseApiError` to inspect `status`, `body`, and `rate_limit`. Network errors are raised by Python's `urllib`.
- HTTPS is required except for localhost development. The default origin is `https://kingel3ba.com`.

Published on PyPI as [`kingpulse-sdk`](https://pypi.org/project/kingpulse-sdk/) version `1.0.0`.
