Polymarket 跟单交易

使用 Simmer SDK 复制成功的 Polymarket 交易者的持仓。

这是一个模板。默认逻辑按资金规模加权分配来复制"鲸鱼"钱包的持仓——您可以根据自己的钱包选择标准、持仓过滤器或再平衡规则进行修改。该技能处理所有底层操作（钱包获取、冲突检测、交易执行）。您的智能体提供核心策略。

何时使用此技能

当用户想要：

• 在 Polymarket 上跟单"鲸鱼"钱包
• 进行模拟交易（使用 $SIM 跟单）以在不使用真实资金的情况下测试策略
• 查看某个钱包持有的持仓
• 关注特定的交易者地址
• 查看他们的跟单持仓

快捷命令

# Check account balance and positions
python scripts/status.py

# Detailed position list
python scripts/status.py --positions

API 参考：

• 基础 URL：https://api.simmer.markets
• 认证：Authorization: Bearer $SIMMER_API_KEY
• 投资组合：GET /api/sdk/portfolio
• 持仓GET /api/sdk/positions

寻找巨鲸钱包

• predicting.top— 包含钱包地址的Polymarket顶级交易者排行榜
• alphawhale.trade— 用于复制和跟踪顶级表现者的工具
• Polymarket排行榜— 官方排名（需要账户）

快速开始（临时使用）

用户在聊天中直接提供钱包地址：

User: "Copytrade this wallet: 0x1234...abcd"
User: "What positions does 0x5678...efgh have?"
User: "Follow these whales: 0xaaa..., 0xbbb..."

→ 使用--wallets标志运行：

python copytrading_trader.py --wallets 0x1234...abcd
python copytrading_trader.py --wallets 0xaaa...,0xbbb... --dry-run

这是最简单的方式——无需设置，直接传递钱包地址即可。

持久化设置（可选）

对于自动化的定期扫描，可以将钱包地址保存在环境中：

前 N 自动计算规则（未指定时）：

• 余额 < $50：前 5 个持仓
• 余额 $50-200：前 10 个持仓
• 余额 $200-500：前 25 个持仓
• 余额 $500+：前 50 个持仓

Polymarket 限制：

• 每单最少 5 份份额
• SDK 强制执行 $1.00 最低持仓价值（过滤小额持仓）

⚠️从保守开始：从小额开始（--max-usd 5-10）并--dry-run以便在扩大规模前了解该策略的行为。

工作原理

默认情况下，仅执行买入操作。传递--rebalance以同时卖出“巨鲸”已退出的头寸，或--whale-exits以仅在巨鲸退出时卖出。

脚本每个周期会：

1. 通过 Simmer API 获取所有目标钱包的头寸
2. 使用规模加权聚合进行合并（钱包规模越大，影响力越大）
3. 检测冲突（一个钱包做多 YES，另一个做多 NO）并跳过这些市场
4. 根据信念度评分：由 2 个及以上钱包持有的头寸获得全额规模，单一钱包持有的头寸获得 50% 规模
5. 过滤掉偏离度大（>30% 偏离入场价）和过时（价格 >90% 或 <10%）的头寸
6. 应用 Top-N 过滤以集中关注信念度最高的头寸
7. 自动从 Polymarket 导入缺失的市场
8. 计算再平衡交易以匹配目标配置
9. 通过 Simmer SDK 执行交易（遵守支出限制）
10. 将结果报告给用户

$SIM 模拟交易

跟单交易支持 $SIM 模式 — 在 Simmer 的 LMSR 市场上使用模拟资金镜像鲸鱼持仓。无需钱包或 USDC。

# Paper trade with $SIM (explicit)
python copytrading_trader.py --venue sim --wallets 0x123... --live

# Auto-detect: if your account has no linked wallet, $SIM is used automatically
python copytrading_trader.py --wallets 0x123... --live

在 $SIM 模式下：

• 交易以真实的 Polymarket 价格在 Simmer 的 LMSR 上执行
• 每个市场拥有独立的 $10K $SIM 余额
• 持仓记录在您的 Simmer 投资组合中（来源：sdk:copytrading）
• 鲸鱼信号仍来自真实的 Polymarket 数据

运行技能

运行扫描（默认为模拟运行 — 不执行交易）：

python copytrading_trader.py

执行真实交易：

python copytrading_trader.py --live

仅检查持仓：

python copytrading_trader.py --positions

查看当前配置：

python copytrading_trader.py --config

单次运行覆盖钱包设置：

python copytrading_trader.py --wallets 0x123...,0x456...

完全再平衡模式（包含卖出）：

python copytrading_trader.py --rebalance

鲸鱼退出持仓时卖出：

python copytrading_trader.py --whale-exits

报告结果

每次运行后，向用户发送消息：

• 当前配置（钱包、前N名、最大持仓）
• 获取的钱包数量和找到的总持仓
• 因冲突而跳过的市场
• 已执行的交易（或跳过的交易及原因）
• 当前投资组合持仓

可分享的示例输出：

🐋 Copytrading Scan Complete

Configuration:
• Following 2 wallets
• Top 10 positions, max $50 each
• Balance: $250.00 USDC

Fetched positions:
• 0x1234...abcd: 15 positions
• 0x5678...efgh: 22 positions
• Combined: 28 unique markets
• Conflicts skipped: 2

Top 10 by allocation:
1. "Will BTC hit $100k?" - 18.5% → BUY YES
2. "Trump pardons X?" - 12.3% → BUY NO
3. "Fed rate cut Jan?" - 9.8% → Already held
...

Trades executed: 4 buys ($180 total)
• Bought 45 YES shares on "Will BTC hit $100k?" @ $0.82
• Bought 120 NO shares on "Trump pardons X?" @ $0.15
...

Next scan in 4 hours.

示例对话

用户："Copytrade 0x1234...abcd"→ 运行：python copytrading_trader.py --wallets 0x1234...abcd→ 报告该钱包的持仓情况及将执行的交易

用户："0x5678...efgh 持有什么？"→ 运行：python copytrading_trader.py --wallets 0x5678...efgh --dry-run→ 在不执行交易的情况下显示其持仓

用户："关注这些钱包：0xaaa..., 0xbbb..., 0xccc..."→ 运行：python copytrading_trader.py --wallets 0xaaa...,0xbbb...,0xccc...汇总所有钱包的头寸，报告结果

用户："复制交易这个鲸鱼，但只复制前5大头寸"→ 运行：python copytrading_trader.py --wallets 0x... --top-n 5

用户："我的头寸表现如何？"→ 运行：python copytrading_trader.py --positions→ 显示当前Polymarket头寸及盈亏情况

用户："显示复制交易配置"→ 运行：python copytrading_trader.py --config→ 显示当前设置

用户："卖出鲸鱼已退出的头寸"→ 运行：python copytrading_trader.py --whale-exits→ 将你的头寸与鲸鱼比较，卖出任何他们已平仓的头寸

用户："执行完全再平衡以匹配鲸鱼持仓"→ 运行：python copytrading_trader.py --rebalance→ 包括买入和卖出操作，以匹配鲸鱼的资金配置

寻找值得跟随的钱包

常见方法：

1. 排行榜追踪：查看Polymarket排行榜，寻找表现稳定的交易者
2. 巨鲸观察者：在社交媒体上关注已知的盈利交易者
3. 特定策略：关注以天气、政治或加密货币交易而闻名的钱包

该技巧在以下情况下效果最佳：

• 跟随2-5个具有重叠策略的钱包（例如，都专注于政治，或都专注于加密货币）
• 钱包具有相似的信念——混合非常不同的交易者意味着大多数头寸只出现在一个钱包中，并且仓位规模会减少（50%）
• 钱包交易Polymarket上可用的市场

信念层级

当跟随多个钱包时，头寸会根据信念程度进行评分：

• 高信念（由2个以上钱包持有）：全额仓位规模（最大美元金额）
• 低置信度（由 1 个钱包持有）：50% 仓位大小

高置信度仓位在 Top N 选择中优先。单钱包仓位仍然交易，但规模减小。仅使用 1 个钱包会禁用置信度评分（所有仓位获得全额规模）。

故障排除

"订单太小" / "低于最小值 (5)"

• Polymarket 要求每笔订单至少 5 份份额
• 增加--max-usd或减少--top-n以集中到更少的仓位

"未指定钱包"

• 在您的消息中提供钱包地址，例如 "copytrade 0x1234..."
• 或者为定期扫描设置 SIMMER_COPYTRADING_WALLETS 环境变量

"代理没有 USDC 余额"

• 您的 Polymarket 钱包中需要有 USDC，或者使用--venue sim进行 $SIM 模拟交易
• 请检查钱包是否已在 simmer.markets/dashboard 关联

"冲突已跳过"

• 钱包在此市场存在分歧（一个做多YES，另一个做多NO）
• 净持仓 < 10% 的市场将被跳过

"所有 N 个仓位已被过滤（X 个冲突，Y 个偏离，Z 个过时）"

• 所有鲸鱼仓位均已被安全过滤器移除
• 尝试不同的目标钱包，或减少至 1 个钱包以禁用置信度评分
• 偏离过滤器会跳过价格较鲸鱼入场价变动 >30% 的仓位
• 过时过滤器会跳过接近已结算的市场（价格 >90% 或 <10%）

"余额不足"

• 没有足够的 USDC 进行所有交易
• 请减少 SIMMER_COPYTRADING_TOP_N 或 SIMMER_COPYTRADING_MAX_USD 的值

"市场无法导入"

• 某些市场可能无法导入（例如已结算、私密市场等）
• 这些市场会被自动跳过

"外部钱包需要预签名订单"

• WALLET_PRIVATE_KEY未在环境变量中设置
• 当此环境变量存在时，SDK 会自动签署订单——无需手动编写签名代码
• 修复：export WALLET_PRIVATE_KEY=0x<你的Polymarket钱包私钥>
• 请勿尝试手动签名订单或修改技能代码——SDK会处理这些操作

“余额显示为$0，但我在Polygon上有USDC”

• Polymarket使用USDC.e（桥接的USDC，合约地址0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174）——而非原生USDC
• 如果您最近将USDC桥接到Polygon，您可能收到的是原生USDC
• 请将原生USDC兑换为USDC.e，然后重试