mirror of
https://github.com/JamesLHW/polymarket-quick-trade.git
synced 2026-08-18 08:08:05 +00:00
80 lines
2.7 KiB
Markdown
80 lines
2.7 KiB
Markdown
# Polymarket Quick Trade & Onchain Leaderboard
|
||
|
||
一个支持 Polymarket 多市场的快捷交易面板，并集成实时的链上盈亏与大户交易排名榜单。
|
||
|
||
## 特性
|
||
- ⚡️ **单键快速下单**: 支持通过键盘快捷键快速进行买入/卖出
|
||
- 📊 **多时间维度市场**: 支持快速切换 BTC/ETH 的 5分钟、15分钟、1小时市场
|
||
- 🏆 **链上大户排行榜**: 实时抓取链上订单数据，统计交易排名 Top 100
|
||
- 🔄 **多账号切换**: 支持配置多个交易账号并在面板中一键切换
|
||
|
||
## 关于“净持仓”排名原理
|
||
|
||
很多数据接口（如 Polymarket Data API）只能看到作为 Taker 的交易量。本工具通过直接扫描 Polygon 链上 CTF 合约的 `TransferSingle` 事件，能够精准捕获 `Maker下单`、`Taker吃单` 甚至 `直接钱包转账` 行为，从而为你还原**最真实、无死角的净持仓排名**。
|
||
|
||
## 环境要求
|
||
|
||
- **Python >= 3.10**
|
||
- **Alchemy API Key** (用于 Polygon RPC 读取链上数据)
|
||
- **Polymarket 交易钱包私钥** (用于下单交易)
|
||
|
||
## 安装步骤
|
||
|
||
1. 克隆本仓库到本地：
|
||
```bash
|
||
git clone https://github.com/JamesLHW/polymarket-quick-trade.git
|
||
cd polymarket-quick-trade
|
||
```
|
||
|
||
2. 安装依赖包：
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
3. 复制配置模板并填写配置：
|
||
```bash
|
||
cp .env.template .env
|
||
```
|
||
- 在 `.env` 里填入你的 `ALCHEMY_KEY`（可在 [alchemy.com](https://www.alchemy.com/) 免费申请）
|
||
- 填入你的 Polymarket 交易钱包私钥 `QUICK_PRIVATE_KEY` 与对应的地址 `QUICK_FUNDER`
|
||
|
||
## 运行方法
|
||
|
||
```bash
|
||
python onchain_leaderboard.py
|
||
```
|
||
|
||
启动后终端会提示：
|
||
```text
|
||
⚡ Quick Trade: http://localhost:8890
|
||
```
|
||
|
||
使用浏览器打开 `http://localhost:8890` 即可使用快速交易面板和查看实时链上榜单。
|
||
|
||
## 快捷键
|
||
|
||
| 按键 | 功能 |
|
||
|------|------|
|
||
| `↑` | 买入 UP |
|
||
| `↓` | 买入 DOWN |
|
||
| `Q` | 卖出全部 UP |
|
||
| `W` | 卖出全部 DOWN |
|
||
| `1`~`5` | 选择金额 ($5 / $10 / $20 / $50 / $100) |
|
||
|
||
## 其他命令
|
||
|
||
```bash
|
||
# 只查询一次当前回合排名（不进入实时监控）
|
||
python onchain_leaderboard.py --once
|
||
|
||
# 指定回合时间戳查询历史排名
|
||
python onchain_leaderboard.py --ts 1775757000
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
> ⚠️ **永远不要将 `.env` 文件提交到 Git！** 里面包含你的私钥。项目已配置 `.gitignore` 自动忽略该文件。
|
||
|
||
> 💡 **作者寄语**：
|
||
> 这是一个我自己平时高频使用的自用工具，目前运行非常稳定。如果大家在安装或使用过程中遇到任何报错或问题，**建议先直接把错误代码发给 ChatGPT/Claude 等 AI 助手排查**。因为项目是完全开源的，所以你可以自由地修改、增加或删除任何你不需要的功能。祝大家交易顺利！
|