# 比特骆驼行情采集分析（market_intel）

独立仓库：**只做行情采集 → 落库 → 分析统计 → 只读展示 / API**。  
与 `eth_hedge_sim`（策略 / 中控）无代码共用、无进程共用、无交易密钥共用。

- 产品名：比特骆驼行情采集分析  
- 安装目录：`/opt/market_intel`  
- 默认端口：`5170`  
- 时区：`Asia/Shanghai`  
- 第一期：OKX ETH 只读行情  

详细实现标准见 [开发方案.md](./开发方案.md)。

## 快速开始（Docker）

```bash
cp .env.example .env
docker compose up -d --build
curl -fsS http://127.0.0.1:5170/health
```

## 一键部署（Ubuntu 22.04）

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

已安装：

```bash
bash /opt/market_intel/deploy/manage.sh
```

## 本地开发

```bash
python -m venv .venv
# Windows: .venv\Scripts\activate
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# 本机 SQLite 路径
# MI_DB_PATH=./data/market_intel.db

set PYTHONPATH=.
python -m apps.collector.main          # 终端 1
uvicorn apps.api.main:app --reload --port 5170   # 终端 2
```

前端（可选）：

```bash
cd web && npm i && npm run build
# 产物挂到 API 静态目录；开发可用 npm run dev（代理到 5170）
```

## 核心口径

1. **期权杠杆** = 标的指数 ÷ 期权卖一（`ask`）  
2. **波动点数** = 到期指数 − 时段代表指数（未到期标记 `pending_expiry=true`）  
3. 统计按上海自然日切分；桶默认 1 小时  

## API（第一期）

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/health` | 存活 + 采集延迟（公开） |
| GET | `/api/auth/status` | 是否需要登录 |
| POST | `/api/auth/login` | 密码换 token（Cookie + JSON） |
| GET | `/api/meta/latest` | 最新 Call/Put 杠杆（需鉴权） |
| GET | `/api/stats/leverage` | 日/周/月时段杠杆聚合 |
| GET | `/api/stats/move_points` | 时段→到期波动（signed/abs；未到期 pending） |
| GET | `/api/stats/ops-map` | 作战地图主接口（杠杆 + 波动） |
| GET | `/api/notify/wecom/status` | 企微配置状态 |
| POST | `/api/notify/wecom/test` | 企微测试推送 |

鉴权：`AUTH_SECRET=disabled` 关闭；否则 `Authorization: Bearer <token>` / Cookie `mi_token`。  
企微：`WECOM_ENABLED=1` + `WECOM_WEBHOOK_URL`；连续失败 ≥ `ALERT_FAIL_THRESHOLD`（默认 5）推送。

## 分期

| 阶段 | 交付 |
|------|------|
| P0 | 骨架、Compose、manage.sh、健康检查 |
| P1 | OKX 指数 + ATM Call/Put 采样落库 |
| P2 | 杠杆日周月统计 + Web 图 |
| P3 | 到期回填 + 波动点数 |
| P4 | 鉴权加固、企微告警 |

## 许可

内部项目。