From 13d929635a8c001aa3948a6421f5ce8c4e3c41fc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Alex=EF=BD=9CPolyEcho?= Date: Sat, 18 Jul 2026 09:55:03 +0800 Subject: [PATCH] Update README with net position details and author note --- README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/README.md b/README.md index 47bf98b..d0ad43d 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,10 @@ - 🏆 **链上大户排行榜**: 实时抓取链上订单数据，统计交易排名 Top 100 - 🔄 **多账号切换**: 支持配置多个交易账号并在面板中一键切换 +## 关于“净持仓”排名原理 + +很多数据接口（如 Polymarket Data API）只能看到作为 Taker 的交易量。本工具通过直接扫描 Polygon 链上 CTF 合约的 `TransferSingle` 事件，能够精准捕获 `Maker下单`、`Taker吃单` 甚至 `直接钱包转账` 行为，从而为你还原**最真实、无死角的净持仓排名**。 + ## 环境要求 - **Python >= 3.10** @@ -70,3 +74,6 @@ python onchain_leaderboard.py --ts 1775757000 ## 注意事项 > ⚠️ **永远不要将 `.env` 文件提交到 Git！** 里面包含你的私钥。项目已配置 `.gitignore` 自动忽略该文件。 + +> 💡 **作者寄语**： +> 这是一个我自己平时高频使用的自用工具，目前运行非常稳定。如果大家在安装或使用过程中遇到任何报错或问题，**建议先直接把错误代码发给 ChatGPT/Claude 等 AI 助手排查**。因为项目是完全开源的，所以你可以自由地修改、增加或删除任何你不需要的功能。祝大家交易顺利！