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

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

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

详细实现标准见 开发方案.md。

快速开始（Docker）

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

一键部署（Ubuntu 22.04）

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

已安装：

bash /opt/market_intel/deploy/manage.sh

本地开发

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

前端（可选）：

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	鉴权加固、企微告警

许可

内部项目。