Docs: Add explanations for emojis, whale tracking and data caching

This commit is contained in:
Alex|PolyEcho
2026-07-18 09:57:41 +08:00
parent 13d929635a
commit dd5fea2922
+15
View File
@@ -61,6 +61,21 @@ python onchain_leaderboard.py
| `W` | 卖出全部 DOWN |
| `1`~`5` | 选择金额 ($5 / $10 / $20 / $50 / $100) |
## 界面图标说明
在终端的排行榜中,你会看到一些特殊图标(Emoji),它们的含义如下:
- 🥇 🥈 🥉:当前回合净持仓数量排名前三名
- 🐋 **鲸鱼 (Whale)**:当你将特定地址加入 `tracked_whales_list.txt` 后,该地址会上榜并显示此图标,同时会实时拉取显示该地址的 Polymarket 用户名及历史总盈亏(PnL)。
- ⚖️ **天平 (Maker/Hedged)**:代表该地址在当前回合双向持仓(可能在做市、或者进行了对冲操作)。
- 🔥 **连胜冒火 (Hot Streak)**:代表该地址在最近的连续几个回合中持续盈利(基于底层 `持仓/` 目录的连胜历史数据追踪)。
## 高级功能与数据缓存
- **追踪特定大户 (`tracked_whales_list.txt`)**:你可以把感兴趣的 Polygon 钱包地址(0x开头)一行一个粘贴到该文件中。**程序支持热重载**,修改文件保存后,下一个 5 分钟回合就会自动生效,无需重启脚本。
- **用户名缓存 (`username_cache.json`)**:程序会自动将链上地址对应的 Polymarket 昵称缓存到该文件,避免频繁请求 Polymarket 接口导致被封 IP。
- **历史记录存档 (`持仓/` 目录)**:每回合结束时,程序会自动将完整的持仓排名和具体的**买入区块信息**保存为 CSV 文件。你可以利用这些 CSV 数据进行二次聚类分析(比如排查多账号女巫攻击或跟随大户建仓时间点)。
## 其他命令
```bash