Polymarket自动交易器

用于Polymarket的全自动预测市场交易代理。使用LLM概率评估来分析市场，通过凯利公式确定仓位大小，并通过非美国VPS上的Polymarket中央限价订单簿API执行交易。

先决条件

• 非美国虚拟专用服务器——Polymarket屏蔽美国IP地址。请使用DigitalOcean阿姆斯特丹、Hetzner欧盟等服务器。
• Polygon钱包内需有USDC.e（桥接USDC，非原生USDC）
• MATIC代币用于支付燃气费（约0.1 MATIC足够进行数百笔交易）
• Anthropic API密钥（使用Haiku模型，每次评估约0.001美元）

设置

1. 虚拟专用服务器环境

通过SSH连接到您的非美国虚拟专用服务器并运行：

python3 {baseDir}/scripts/setup_vps.sh

或手动操作：

apt update && apt install -y python3 python3-venv
python3 -m venv /opt/trader
/opt/trader/bin/pip install py-clob-client python-dotenv web3 requests

2. 配置

创建/opt/trader/app/.env文件：

PRIVATE_KEY=<your-polygon-wallet-private-key>
LLM_API_KEY=<your-anthropic-api-key>

3. 区块链授权

交易前，请为Polymarket合约批准USDC.e和CTF代币。运行：

python3 {baseDir}/scripts/approve_contracts.py

所需批准（共6项）：

• USDC.e → CTF交易所、Neg Risk交易所、Neg Risk适配器
• CTF → CTF交易所、Neg Risk交易所、Neg Risk适配器

4. 部署交易脚本

cp {baseDir}/scripts/run_trade.py /opt/trader/app/
cp {baseDir}/scripts/pnl_tracker.py /opt/trader/app/

5. 定时自动化

crontab -e
# Add: */10 * * * * cd /opt/trader/app && /opt/trader/bin/python3 run_trade.py >> cron.log 2>&1

运作原理

1. 市场扫描— 从Gamma API获取活跃市场，根据流动性和时间范围进行筛选
2. LLM评估— 请Claude Haiku估算每个市场的真实概率
3. 优势检测— 比较LLM公允价值与市场价格（最小优势阈值为5%）
4. 凯利仓位计算— 采用半凯利准则，最大仓位上限为25%
5. 订单执行— 通过CLOB API以GTC（直至取消有效）方式下达限价订单
6. 去重— 在trades.jsonl中跟踪所有交易跳过已交易市场
7. 预算控制— 将LLM推理成本与交易资金分开追踪

交易参数

可在run_trade.py中配置：

• EDGE_THRESHOLD— 最小交易优势（默认值：0.05 = 5%）
• MIN_SHARES— 最小订单规模（Polymarket要求≥5份）
• 资金分配：80%可用，单笔交易上限25%，单一头寸上限30%
• 市场期限：优先处理30天内结束的市场

监控

随时查看盈亏：

python3 /opt/trader/app/pnl_tracker.py

查看近期活动：

tail -50 /opt/trader/app/cron.log

关键技术细节

• 钱包类型：外部拥有账户（signature_type=0），非代理钱包
• 代币：USDC.e (0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174），非原生USDC
• 负风险市场（选举、体育联赛）需要USDC.e批准才能使用负风险适配器（0xd91E80cF2E7be2e162c6513ceD06f1dD0dA35296）
• 美国地理封锁— 所有API调用必须源自非美国IP。VPN无效；请使用真实的非美国VPS。

成本

• LLM推理：每次市场评估约$0.001（Haiku）
• 典型周期（40次评估）：约$0.04
• Gas费：在Polygon上可忽略不计（每笔交易约$0.001）

⚠️ 安全注意事项

• 请使用资金最少的专用钱包。切勿使用您主钱包的私钥。创建一个全新的钱包，并仅存入您愿意承担风险的金额。
• 私钥存储在磁盘上的.env文件中。请加固您的VPS：设置严格的文件权限（chmod 600 .env）、禁止共享访问、配置防火墙、仅使用SSH密钥。
• 最大无符号整数审批在去中心化金融中很常见，但授予了广泛的支出权限。已批准的合约是Polymarket的官方合约。运行前请先审查references/contract-addresses.md中的地址。
• 首先用小额资金测试（5-10美元），然后再逐步增加。
• 主动监控——检查cron.log并定期运行pnl_tracker.py。
• LLM_API_KEY计费——每个周期成本约0.04美元（Haiku模型）。请在您的Anthropic账户上设置账单提醒。
• 这是自主交易软件。程序错误或市场状况可能导致损失。使用时风险自负。

参考资料

• 查看references/polymarket-api.md获取完整的CLOB API文档
• 参见references/contract-addresses.md适用于所有 Polygon 合约地址