polymarket-signal-sniper

name	polymarket-signal-sniper
description	从您自己的信号源中捕捉 Polymarket 的投资机会。使用具备 Trading Agent 级别安全性的工具来监控 RSS 源。
metadata	{"author":"Simmer (@simmer_markets)","version":"1.5.2","displayName":"Polymarket Signal Sniper","difficulty":"intermediate"}

Polymarket Signal Sniper

这是一个用于捕捉市场信号的自动化工具，它结合了Simmer的交易智能。

注意： 这只是一个模板。默认的信号来源是RSS订阅源，您可以根据需要将其替换为其他数据源（如API、Webhook或自定义数据抓取工具）。该工具会负责所有的市场匹配、风险控制以及交易执行等底层逻辑，而用户需要提供交易策略（即“alpha”部分）。

适用场景

当用户希望：

• 监控RSS订阅源以寻找交易机会
• 在市场反应之前根据突发新闻进行交易
• 自定义信号来源和关键词
• 为交易设置高级的风险保护机制时，可以使用此工具。

设置流程

当用户请求安装或配置此工具时，请按照以下步骤操作：

1. 安装Simmer SDK

   pip install simmer-sdk
   

2. 获取Simmer API密钥

   • 用户可以从simmer.markets/dashboard的“SDK”选项卡中获取API密钥。
   • 将密钥存储在环境变量SIMMER_API_KEY中。

3. 提供钱包私钥（用于实时交易）

   • 这是用户在Polymarket钱包中的私钥（该钱包用于存放USDC）。
   • 将私钥存储在环境变量WALLET_PRIVATE_KEY中。
   • SDK会使用此密钥在客户端自动签署交易订单，无需手动操作。
   • 在使用Simmer平台进行模拟交易（$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

快速入门（临时使用）

用户提供RSS订阅源和目标市场信息：

User: "Watch this RSS feed for greenland news: https://news.google.com/rss/search?q=greenland"
User: "Snipe any news about trump from this feed"

使用--feed和--market参数运行工具：

python signal_sniper.py --feed "https://news.google.com/rss/search?q=greenland" --market "greenland-acquisition" --dry-run

持久化配置（可选）

为了实现自动化的定期扫描，请通过环境变量进行配置：

配置项	环境变量	默认值	说明
RSS订阅源	SIMMER_SNIPER_FEEDS	（无）	用逗号分隔的RSS地址列表
目标市场	SIMMER_SNIPERMARKETS	（自动检测）	用逗号分隔的市场ID列表；若未设置关键词，则自动从用户输入的关键词中识别市场
关键词	SIMMER_SNIPER_KEYWORDS	（无）	用于匹配的文章关键词
交易信心值	SIMMER_SNIPER_CONFIDENCE	0.7	最低交易信心值（0.0-1.0）
每笔交易的最大金额（USD）	SIMMER_SNIPER_MAX_USD	25	每笔交易的最大金额
每次扫描的最大交易数量	SIMMER_SNIPER_MAX_TRADES	5	每次扫描的最大交易次数

Polymarket的限制：

• 每笔交易至少需要5份资产。
• 低于此数量的交易将被拒绝，并显示错误信息。

工作原理

脚本的工作流程如下：

1. 每次扫描时，会轮询配置的RSS订阅源。
2. 根据用户设置的关键词过滤文章。
3. 将匹配到的文章与目标市场进行匹配（若未设置市场，则自动从关键词中识别目标市场）。
4. 对于每个匹配结果，调用SDK的相应接口进行风险检查：
   • 检查用户当前的持仓情况
   • 判断市场是否出现价格反转（例如最近的方向变化）
   • 评估市场的流动性（是否容易发生滑点）
   • 判断市场是否即将达成某种状态（如“解决”）
   • 根据具体条件判断是否适合进行交易。
5. 如果风险检查通过，根据文章的情感倾向决定交易方向。
6. 通过SDK执行交易（同时遵守每次扫描的最大交易数量限制）。
7. 记录已处理的文章内容，避免重复处理。

运行工具

执行扫描（默认为模拟运行，不进行实际交易）：

python signal_sniper.py

执行真实交易：

python signal_sniper.py --live

仅查看信号信息（不执行交易）：

python signal_sniper.py --scan-only

查看当前配置：

python signal_sniper.py --config

针对单次运行进行临时配置：

python signal_sniper.py --feed "https://..." --keywords "trump,greenland" --market "abc123"

查看已处理的文章：

python signal_sniper.py --history

解读警告信息

在交易前，请务必查看警告信息。系统会显示以下几种警告：

• MARKET RESOLVED：此时不宜进行交易。
• HIGH URGENCY: Resolves in Xh：判断信号是否及时。
• flip_flop_warning: SEVERE：市场波动剧烈，建议避开。
• flip_flop_warning: CAUTION：需谨慎操作，需要更明确的交易信号。
• Wide spread (X%)：市场波动较大，建议减少持仓规模或跳过此次交易。
• Simmer AI signal: X% more bullish/bearish：参考Simmer的预测意见。

分析信号

找到匹配的文章后，请仔细分析：

1. 阅读标题和摘要：了解新闻的具体内容。
2. 检查市场达成条件：确认该新闻是否真正符合交易条件。
   • 例如，标题中的“greenland”并不一定意味着“收购完成”，可能需要进一步确认具体内容。
3. 评估信号可信度（0.0-1.0）：判断信号与市场达成条件的关联程度以及消息来源的可靠性。
4. 仅当满足以下条件时进行交易：
   • 信号信心值大于设定阈值（默认0.7）。
   • 无严重警告。
   • 信号内容与市场达成条件相符。

示例对话

用户：“为Greenland市场设置新闻捕捉功能”

• 提供要监控的RSS订阅源。
• 配置目标市场ID和关键词。
• 设置定时任务以自动执行扫描。

用户：“检查这个RSS源中的交易信号”

• 运行命令：python signal_sniper.py --feed "URL" --scan-only
• 查看找到的文章和潜在的交易机会。

用户：“从CoinDesk获取比特币相关的交易信号”

• 指定CoinDesk的RSS源和相关的市场。
• 查看匹配结果并决定是否进行交易。

用户：“我们处理了哪些交易信号？”

• 运行命令：python signal_sniper.py --history
• 查看最近的处理记录和交易结果。

示例交易流程

1. RSS poll finds: "Trump and Denmark reach preliminary Greenland agreement"
2. Keywords match: "greenland", "trump"
3. Call context endpoint for market "greenland-acquisition-2027"
4. Check warnings: none severe ✓
5. Resolution criteria: "Resolves YES if US formally acquires Greenland by 2027"
6. You analyze: "preliminary agreement" ≠ "formally acquires" but bullish signal
7. Confidence: 0.75 (positive indicator, not definitive)
8. Check slippage: 2.5% on $25 ✓
9. Execute: BUY YES $25
10. Report: "🎯 Sniped: Trump/Greenland agreement → BUY YES $25"

故障排除

“未配置RSS订阅源”

• 在提示中提供RSS地址：watch this RSS: https://...
• 或者将地址设置到环境变量SIMMER_SNIPER_feedS中。

“未找到匹配文章”

• 确认关键词是否正确；可能是RSS源没有最新文章。
• 可以尝试使用--scan-only选项查看订阅源的内容。

“因市场波动剧烈而跳过交易”

• 市场流动性差，建议等待时机或寻找新的交易机会。

“滑点过高”

• 市场流动性不足，建议减少交易规模或跳过此次交易。

“文章已处理过”

• 该文章已被系统记录，系统会避免重复处理。

“外部钱包需要预签名订单”

• 确保环境变量WALLET_PRIVATE_KEY已设置。
• SDK会在该变量存在的情况下自动签署订单，无需手动操作。
• 解决方法：export WALLET_PRIVATE_KEY=0x<your-polymarket-wallet-private-key>
• 请勿尝试手动签署订单或修改代码，SDK会自动处理。

“账户余额显示为0美元，但我有Polygon钱包中的资金”

• Polymarket V2（2026-04-28版本）使用的是pUSD（由USDC.e支持）。如果您的钱包中持有USDC.e，请访问simmer.markets/dashboard进行迁移（大约需要30秒）。
• 如果您使用的是Circle平台的USDC，请先将其转换为USDC.e，再迁移至pUSD。
• 完整迁移指南：docs.simmer.markets/v2-migration。

选择合适的RSS订阅源

以下是一些建议：

• Google News RSS：https://news.google.com/rss/search?q=YOUR_TOPIC
• 专业领域来源：通常比主流新闻来源更可靠，因为它们的新闻往往未被市场迅速反映。
• 官方来源：如政府或公司的公告。
• Twitter列表的RSS订阅：可以使用Nitter或RSS.app等工具获取相关内容。

该工具在以下情况下效果最佳：

• 订阅源与目标市场相关。
• 您有明确的关键词来过滤无关信息。
• 来源在主流媒体之前发布新闻。