# okx

**Repository Path**: lu_bingda/okx

## Basic Information

- **Project Name**: okx
- **Description**: 欧易量化交易项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-05
- **Last Updated**: 2026-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OKX 量化交易平台

基于 OKX API 的加密货币量化交易平台，支持策略管理、回测、实时行情与手动交易。

## 功能模块

- **仪表盘** — 账户总览、资产分布、盈亏统计
- **行情数据** — 实时行情、K线图表、交易对信息
- **策略管理** — 创建/编辑/启停量化策略
- **策略回测** — 基于历史K线的策略回测与绩效分析
- **交易操作** — 手动下单、撤单、历史订单查询

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端框架 | FastAPI + Uvicorn |
| OKX SDK | python-okx |
| ORM | SQLAlchemy + SQLite |
| 数据处理 | Pandas + NumPy |
| 实时推送 | WebSocket |
| 前端框架 | React 18 + TypeScript |
| UI 组件库 | Ant Design 5 |
| 图表 | ECharts + Lightweight Charts |
| 状态管理 | Zustand |

## 快速开始

### 环境要求

- Python 3.10+
- Node.js 18+
- （可选）Redis 7+

### 后端

```bash
cd backend
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env 填入你的 OKX API Key
python -m app.main
```

服务运行在 http://localhost:8000，API 文档 http://localhost:8000/api/docs

### 前端

```bash
cd frontend
npm install
npm run dev
```

服务运行在 http://localhost:5173

### Docker 部署

```bash
docker-compose up -d
```

## 环境变量

复制 `backend/.env.example` 为 `backend/.env`，配置以下变量：

```env
OKX_API_KEY=           # OKX API Key
OKX_SECRET_KEY=        # OKX Secret Key
OKX_PASSPHRASE=        # OKX Passphrase
OKX_FLAG=1             # 1=模拟盘, 0=实盘（建议先用模拟盘测试）
DATABASE_URL=sqlite:///./okx_quant.db
REDIS_HOST=localhost
SECRET_KEY=            # JWT 密钥
```

## 项目结构

```
├── backend/
│   ├── app/
│   │   ├── api/routes/      # API 路由
│   │   ├── core/            # 核心模块（OKX客户端、WebSocket、配置）
│   │   ├── models/          # 数据库模型
│   │   ├── services/        # 业务逻辑
│   │   └── main.py          # 应用入口
│   └── requirements.txt
├── frontend/
│   └── src/
│       ├── api/             # API 调用封装
│       ├── pages/           # 页面组件
│       └── layouts/         # 布局组件
└── docker-compose.yml
```

## API 接口

| 模块 | 前缀 | 说明 |
|------|------|------|
| 行情数据 | `/api/market` | 行情、K线、交易产品信息 |
| 账户管理 | `/api/account` | 余额、持仓 |
| 策略管理 | `/api/strategy` | 策略 CRUD、启停 |
| 策略回测 | `/api/backtest` | 历史数据回测 |
| 交易操作 | `/api/trade` | 下单、撤单、历史订单 |
| 系统 | `/api/health` | 健康检查 |
| WebSocket | `/ws` | 实时数据推送 |