dekun
93 lines
2.8 KiB
Markdown
93 lines
2.8 KiB
Markdown
# 比特骆驼行情采集分析（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 | 鉴权加固、企微告警 |
|
||
|
||
## 许可
|
||
|
||
内部项目。
|