diff --git a/README.md b/README.md index d0ad43d..3261b11 100644 --- a/README.md +++ b/README.md @@ -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