dekun
910c938d0a
Add page pauses, exponential backoff, and cooldown before swap fallback to avoid rate limits. Co-authored-by: Cursor <cursoragent@cursor.com>
112 lines
3.7 KiB
Markdown
112 lines
3.7 KiB
Markdown
# 振幅统计（中控）
|
||
|
||
中控只读工具：按自定义整点起点、**固定北京时间 16:00 收窗**，统计 OKX 上 ETH/BTC 的历史「点数振幅」档案，辅助一天期期权判断空间。
|
||
|
||
> 开发方案见 [ETH时段振幅统计-开发方案.md](./ETH时段振幅统计-开发方案.md)。
|
||
> **不改下单链路**；不算 IV / 权利金。
|
||
|
||
---
|
||
|
||
## 入口
|
||
|
||
- 顶栏 **振幅统计**（`/amp-stats`）
|
||
- 手机端：**更多 → 振幅统计**
|
||
- 可在系统设置里隐藏该导航
|
||
|
||
---
|
||
|
||
## 怎么用
|
||
|
||
1. 打开 **统计** Tab
|
||
2. 选择 **标的** ETH / BTC；数据源固定 **OKX**
|
||
3. **起点整点**（00–23）；终点固定 **16:00**
|
||
4. **周期**：1 月 / 2 月 / 3 月 / 半年 / 1 年 / 自定义天数（默认 2 个月）
|
||
5. 点 **计算** → 下方看汇总 + 分页日表
|
||
6. 需要留存时点 **保存到历史**；**下载 CSV** 含摘要 + 全日明细
|
||
|
||
**跨天例子**
|
||
|
||
| 起点 | 含义（结算日 D） |
|
||
|------|------------------|
|
||
| 22:00 | 昨天 22:00 → 今天 16:00 |
|
||
| 16:00 | 昨天 16:00 → 今天 16:00 |
|
||
| 08:00 | 今天 08:00 → 今天 16:00 |
|
||
|
||
未到当日 16:00 的「今天」不入样本。
|
||
|
||
---
|
||
|
||
## 指标（点数）
|
||
|
||
设开盘 O、最高 H、最低 L、收盘 C：
|
||
|
||
| 字段 | 算法 |
|
||
|------|------|
|
||
| 开→高 | `H − O` |
|
||
| 开→低 | `O − L` |
|
||
| **振幅** | `H − L`（= 开→高 + 开→低） |
|
||
| 涨跌值 | `C − O` |
|
||
|
||
例：O=2000，H=2500，L=1800 → 开→高 500，开→低 200，振幅 **700**。
|
||
|
||
汇总必含：最大振幅（及日期）、开→高/开→低的最大与均值等。
|
||
|
||
K 线粒度：**1H**（与整点对齐）；价源优先 OKX 指数（ETH-USD / BTC-USD），失败再降级永续标记。
|
||
近期 K 线接口约仅 **1440** 根（1H≈60 天）；更长周期自动续拉 `history-index-candles` / `history-candles`。
|
||
分页带间隔，遇 OKX **429** 会自动退避重试（长周期首次会慢一些）。
|
||
|
||
---
|
||
|
||
## 买跨对照（赌波动）
|
||
|
||
表单可填 **双边权利金（点）**，例如 `30`；旁边可填 **止盈点**（可空）：
|
||
|
||
| 汇总项 | 口径 |
|
||
|--------|------|
|
||
| 开→高超过权利金 | `H−O > 权利金` 的天数与占比 |
|
||
| 开→低超过权利金 | `O−L > 权利金` 的天数与占比 |
|
||
| \|涨跌\|超过权利金 | `\|C−O\| > 权利金` 的天数与占比 |
|
||
| 有效波动 | 若设止盈且 `开→高≥止盈` 或 `开→低≥止盈` → 用止盈点；否则用 `\|C−O\|` |
|
||
| 买跨收益 | `有效波动 − 权利金`（日表「收益」列同口径） |
|
||
|
||
- 方向：**买跨**
|
||
- 权利金越过：严格 **`>`**；止盈触达：**`≥`**
|
||
- 止盈留空 / ≤0：有效波动一律按 `|涨跌|`
|
||
- 已算出日表后，改权利金 / 止盈 / 周末筛选会**本地重算**（不重拉 K 线）
|
||
|
||
### 周末
|
||
|
||
- 下拉：**全部**（默认）/ **排除周末** / **仅周末**
|
||
- 按 **结算日** 北京时间星期判断；表中六、日带标注并高亮
|
||
|
||
---
|
||
|
||
## 历史 Tab
|
||
|
||
- 仅 **保存到历史** 后出现（不会一算就自动入库）
|
||
- 可查看、再下载、删除
|
||
- 数据文件：`manual_trading_hub/amp_stats_history.json`（勿当密钥提交）
|
||
|
||
---
|
||
|
||
## 相关代码
|
||
|
||
| 路径 | 说明 |
|
||
|------|------|
|
||
| `lib/hub/amp_stats_lib.py` | 切窗、汇总、OKX 拉取、CSV |
|
||
| `manual_trading_hub/amp_stats_routes.py` | API |
|
||
| `manual_trading_hub/amp_stats_store.py` | 历史 JSON |
|
||
| `manual_trading_hub/static/amp_stats.js` | 前端 |
|
||
| `tests/test_amp_stats_lib.py` | 单元测试 |
|
||
|
||
---
|
||
|
||
## 修订
|
||
|
||
| 日期 | 说明 |
|
||
|------|------|
|
||
| 2026-07-23 | 首版上线说明 |
|
||
| 2026-07-23 | 买跨对照：可设双边权利金、越过占比与收盘盈亏 |
|
||
| 2026-07-23 | 周末筛选/标注、止盈点(≥)、日表收益列 |
|
||
| 2026-07-23 | 长周期续拉 history K 线；收益列红绿着色 |
|