# ⚡ 跨交易所永续合约套利监控

Bitget ↔ HyperLiquid 跨交易所永续合约价差套利系统。支持模拟盘/实盘交易、价差监控、自动开仓/加仓/平仓、Web 仪表盘。

## 功能特点

- **实时价差监控** — 200ms 扫描间隔，追踪 DOGE/LINK/ONDO/OP/WIF/ARB 六个币种
- **自动套利交易** — 价差超过阈值自动开仓，收敛自动平仓，支持多级加仓
- **模拟/实盘双模式** — `TestMode` 控制，模拟模式无需真实 API Key
- **Web 仪表盘** — Go 内置 HTTP Server + Vite React 前端，SSE 实时推送
- **SQLite 持久化** — 交易记录、订单明细、手续费明细全量存储
- **手续费精确计算** — 逐笔累加实际 USD 手续费（开仓费+平仓费），非百分比估算
- **交易所独立资金管理** — 每交易所 $500 初始资金，开仓前检查两边余额充足
- **模拟滑点** — 可配置 `mock_slippage_pct`，模拟真实滑点对净利的影响
- **持仓详情弹窗** — 点击持仓卡片查看完整交易详情（价差、PnL、手续费分腿）
- **Telegram 通知** — 开仓/平仓/异常实时推送

## 架构

```
┌─────────────────────────────────────────────────┐
│ scanner.go   ← 每 200ms 扫描价差                   │
│   ↓ 发现机会 (NetProfit > 阈值)                     │
│ trader.go    ← 开仓/加仓/平仓逻辑                    │
│   ↓ 持久化                                          │
│ db/          ← SQLite (trades / orders / system)   │
│   ↓ SSE 推送                                        │
│ dashboard.go ← HTTP Server :8888                    │
│   ↓                                                │
│ frontend/    ← Vite + React 仪表盘                  │
└─────────────────────────────────────────────────┘
```

## 快速开始

### 1. 配置

编辑 `config.json`：

```json
{
  "scan_interval_ms": 200,
  "trade_enabled": true,
  "test_mode": true,
  "trade_threshold": 0.20,
  "take_profit_pct": 0.20,
  "mock_slippage_pct": 0.05,
  "trade_amount_usd": 5,
  "max_positions": 5,
  "initial_capital": 500,
  "taker_fee_bitget": 0.060,
  "taker_fee_hyperliquid": 0.045,
  "telegram_bot_token": "xxx",
  "telegram_chat_id": "xxx"
}
```

### 2. 启动

```bash
# 一键启动（自动清理旧进程 + 编译 + 运行）
bash start.sh

# 清空数据库 + 启动
bash start.sh --clean

# 强制重新编译 + 启动
bash start.sh --rebuild
```

仪表盘地址：http://localhost:8888

### 3. 前端开发

```bash
cd frontend
npm install
npm run dev   # 开发模式 (Vite HMR :5173)
npm run build # 构建生产版本
```

后端优先从 `frontend/dist/` 读取静态文件（热加载），回退到 Go embed。

## 配置参数

| 参数 | 说明 | 默认 |
|------|------|------|
| `scan_interval_ms` | 扫描间隔 (ms) | 200 |
| `trade_threshold` | 开仓净利阈值 (%) | 0.20 |
| `take_profit_pct` | 止盈净利 (%) | 0.20 |
| `mock_slippage_pct` | 模拟滑点 (%) | 0.05 |
| `trade_amount_usd` | 每腿交易额 ($) | 5 |
| `max_positions` | 最大并行持仓 | 5 |
| `taker_fee_bitget` | Bitget 吃单费率 (%) | 0.060 |
| `taker_fee_hyperliquid` | HyperLiquid 吃单费率 (%) | 0.045 |
| `scale_step_pct` | 加仓步长 (%) | 0.10 |
| `position_timeout` | 最长持仓时间 | 10m |
| `leg_delay` | 两腿下单间隔 | 300ms |
| `initial_capital` | 每交易所初始资金 ($) | 500 |

## 数据库

SQLite (`data/trades.db`)，三张核心表：

| 表 | 说明 |
|----|------|
| `trades` | 交易主表 — 价差、PnL、手续费 ($) |
| `orders` | 订单明细 — 每腿的开仓/加仓/平仓、手续费 ($) |
| `system_orders` | 系统订单 — 双向关联 long↔short 订单 |

## 版本历史

### v1.3 (当前)
- ✨ **交易所独立资金管理** — 每交易所 $500 初始资金，开仓前检查余额
- ✨ **持仓点击详情弹窗** — 点击持仓卡片弹出完整交易详情
- ✨ **模拟滑点** — 新增 `mock_slippage_pct` 配置，模拟真实成交滑点
- ✨ **止损硬编码** — 取消 `SpreadReverseExitPct` 配置，价差 <= 0 硬止损
- 🐛 修复 DB 迁移 tab 字符损坏导致历史交易数据不显示
- 📊 PnL 统计分腿存储（`pnl_long_usd`/`pnl_short_usd`/`fee_long_usd`/`fee_short_usd`）

### v1.2.1
- ✨ scale-in 后 leg.EntryPrice 更新为加权平均（`weightedAvgPrice`）
- ✨ 进程重启恢复仓位时，从 `orders` 表加载 scale prices，重建完整价格切片
- ✨ 新增 `GetScalePrices()` DB 方法

### v1.2
- ✨ `system_orders` 表，记录系统级开仓/加仓/平仓
- ✨ 手续费改为逐笔累加 USD，不再用百分比估算
- ✨ Vite + React 前端，支持热加载
- ✨ Web 仪表盘持仓 PnL 美元化显示
- 🐛 修复 `persistTrade` 费用在 `SaveTrade` 后才累加导致 fee=0 的 bug
- 🗑 移除老版 Chart.js 图表