# crypto_okx

基于 **Flask** 的 **OKX 期权 / 对冲** 独立系统.仓库:[https://git.bz121.com/dekun/crypto_okx.git](https://git.bz121.com/dekun/crypto_okx.git)

## 功能概要

- **期权**:`/options`
- **期权复盘**:`/options/review`
- **对冲计划**:`/hedge-plan`
- **模拟资金**:系统设置可切换模拟/实盘
- **实盘(可选)**:`LIVE_TRADING_ENABLED=true` + OKX API

与中控 / `manual_trading_hub` / 其它交易所实例无依赖.

## 一键部署(Ubuntu)

```bash
curl -fsSL https://git.bz121.com/dekun/crypto_okx/raw/branch/main/deploy/manage.sh | bash
```

安装到 `/opt/crypto_okx`,PM2 进程名 `crypto_okx`,默认端口 **5004**.

详见 **[部署文档.md](./部署文档.md)**、**[deploy/README.md](./deploy/README.md)**.

## 环境要求

- Python 3.10+
- 依赖:`requirements.txt`(SOCKS 需 **PySocks**)
- 生产建议 Ubuntu 22.04/24.04 + PM2

## 配置

完整模板见 **`.env.example`**.常用变量:

| 变量 | 说明 |
|------|------|
| `OKX_API_KEY` / `OKX_API_SECRET` / `OKX_API_PASSPHRASE` | OKX API |
| `OKX_SOCKS_PROXY` | 如 `socks5h://127.0.0.1:1080` |
| `APP_PORT` | 默认 `5004` |
| `SIM_DEFAULT_MODE` | `sim` / `live` |

## 本地运行

```bash
cd /opt/crypto_okx
cp -n .env.example .env
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python app.py
```

或:

```bash
bash deploy/setup_env.sh
pm2 start ecosystem.config.cjs
```

## 自检

```bash
python scripts/verify_okx_funding.py
```

## 风险与合规

实盘风险自负;请确认 API 权限与 IP 白名单.