Metadata-Version: 2.4
Name: panda-trade
Version: 0.1.3
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 -U panda-trade
```

## 登录

```python
from panda_trade import login

login()
```

SDK 使用 OAuth + PKCE 打开 PandaAI 官网统一登录页，不需要 API Key，也不会保存官网密码。
浏览器已经登录官网时会直接完成赛事账户授权；未登录时在官网登录，登录后自动回到
Python 本地回调。凭证保存在用户目录的 `.panda-trade/credentials.json`。

也可以使用命令行：

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

当前发布版本：`0.1.3`。SDK 使用的登录账号是 PandaAI 官网账号，不能把密码写入代码或提交到仓库。

服务器没有图形界面时，请在有浏览器的设备打开 CLI 输出的设备验证地址；官网登录态确认后
会自动完成授权，Python 客户端无需接收或保存官网账号密码。

## 交易示例

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