Metadata-Version: 2.4
Name: panda-trade
Version: 0.1.0
Summary: PandaAI 交易开放 API 的 Python SDK / CLI（OAuth 登录，无需 API Key）
Project-URL: Homepage, https://www.pandaaiquant.com
Keywords: pandaai,futures,trading,contest,oauth
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24

# panda-trade

PandaAI 期货仿真交易大赛 Python SDK。默认连接：
`https://www.pandaaiquant.com/openapi/v1`。

## 安装

```bash
pip install panda-trade
```

## 登录

```python
from panda_trade import login

login()
```

SDK 使用 OAuth + PKCE 打开官网授权页，不需要 API Key，也不会保存官网密码。凭证保存在
用户目录的 `.panda-trade/credentials.json`。

也可以使用命令行：

```bash
panda-trade login
panda-trade whoami
panda-trade doctor
```

## 交易示例

```python
from panda_trade import Client

client = Client()

print(client.snapshot())
print(client.quote("rb2610"))

# 发布策略前先使用 dry_run 验证
result = client.buy_open("rb2610", 1, price=3000, dry_run=True)
print(result)
```

通过环境变量覆盖服务地址或 OAuth client：

```text
PANDA_TRADE_BASE_URL
PANDA_TRADE_CLIENT_ID
PANDA_TRADE_HOME
```
