polymarket-fast-loop

---

name: polymarket-fast-loop description: 使用 Simmer API，根据 CEX（中心化交易所）的价格动量信号，在 Polymarket 上进行 5 分钟和 15 分钟周期的快速交易。默认使用的信号数据来自 Binance 的 BTC/USDT 交易记录（klines）。适用于用户希望进行快速交易、自动化短期加密货币交易，或利用 CEX 的价格动量作为 Polymarket 的交易决策依据的情况。 metadata: author: Simmer (@simmer_markets) version: "1.6.3" displayName: Polymarket FastLoop Trader difficulty: advanced ---# Polymarket FastLoop Trader

该技能允许用户利用实时价格信号，在Polymarket的5分钟快速交易市场中进行交易。默认使用的是来自Binance的BTC价格信号；同样也支持ETH和SOL资产。

**仅适用于Polymarket市场。**所有交易均在Polymarket上进行，并使用USDC作为交易货币。使用--live选项可进行实时交易，否则将以模拟模式运行。

**这是一个模板。**默认使用的Binance价格信号可帮助您快速开始交易——您可以根据自己的需求替换为其他信号源或策略。该技能会处理所有市场发现、数据导入和交易执行等基础工作，您只需提供交易策略即可。

⚠️ 快速交易市场需支付Polymarket规定的10%手续费（is_paid: true），请在交易策略中考虑这一费用。

⚠️ **风险监控功能不适用于时长小于15分钟的市场。**Simmer的止损和止盈机制每15分钟检查一次交易状态，因此在5分钟或15分钟的市场中，这些机制可能不会被触发。您在Simmer控制台中设置的风险参数对这些市场无效。请根据实际情况调整交易规模，并且不要依赖自动止损功能来控制快速交易的风险。

市场查找方式

• 直接通过Polymarket的Gamma API查询实时快速交易市场（无需依赖Simmer的市场列表）
• 每个周期都会自动发现新的市场
• 支持BTC、ETH和SOL资产——只需更改--set asset参数即可选择目标资产，或指定想要查询的市场
• 脚本每5分钟运行一次，以捕捉每个交易窗口的机会（或每1分钟运行一次，以捕捉窗口内的交易机会）

您无需等待Simmer自动显示市场列表。FastLoop会实时在Polymarket中查找市场，然后通过Simmer进行交易。

适用场景

• 当用户希望在任何支持的资产上进行5分钟或15分钟的快速交易时
• 用于自动化短期加密货币交易策略
• 希望使用CEX的价格信号（或自定义信号）作为交易依据
• 需要监控快速交易市场的持仓情况

设置流程

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

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会使用此密钥在客户端自动签名交易订单，无需手动操作

4. 确认配置参数

   • 选择交易资产（BTC、ETH或SOL，默认为BTC）
   • entry_threshold：触发交易的最低价格波动幅度（默认为5美分）
   • max_position：单次交易的最大金额（默认为5美元）
   • window：交易窗口时长（5分钟或15分钟，默认为5分钟）

5. 设置定时任务或循环执行

   • 由用户自行安排执行频率（详见“如何设置循环执行”部分）

快速入门

# Set your API key
export SIMMER_API_KEY="your-key-here"

# Dry run — see what would happen
python fastloop_trader.py

# Go live
python fastloop_trader.py --live

# Live + quiet (for cron/heartbeat loops)
python fastloop_trader.py --live --quiet

# Live + smart sizing (5% of balance per trade)
python fastloop_trader.py --live --smart-sizing --quiet

如何设置循环执行

脚本会按照预设的周期自动运行——用户需要配置定时任务或循环执行机制：

Linux crontab（本地或VPS环境）：

# Every 5 minutes (one per fast market window)
*/5 * * * * cd /path/to/skill && python fastloop_trader.py --live --quiet

# Every 1 minute (more aggressive, catches mid-window opportunities)
* * * * * cd /path/to/skill && python fastloop_trader.py --live --quiet

OpenClaw原生定时任务（容器化或OpenClaw管理的环境）：

openclaw cron add \
  --name "Fast Loop Trader" \
  --cron "*/5 * * * *" \
  --tz "UTC" \
  --session isolated \
  --message "Run fast loop trader: cd /path/to/skill && python fastloop_trader.py --live --quiet. Show the output summary." \
  --announce

通过OpenClaw的Heartbeat功能执行：

Run: cd /path/to/fast market && python fastloop_trader.py --live --quiet

配置参数

配置参数可通过config.json文件、环境变量或--set命令进行调整：

# Change entry threshold
python fastloop_trader.py --set entry_threshold=0.08

# Trade ETH instead of BTC
python fastloop_trader.py --set asset=ETH

# Multiple settings
python fastloop_trader.py --set min_momentum_pct=0.3 --set max_position=10

配置选项

参数	默认值	环境变量	说明
entry_threshold	0.05	SIMMER_SPRINT_ENTRY	触发交易的最低价格波动幅度（50美分）
min_momentum_pct	0.5	SIMMER_SPRINT_MOMENTUM	触发交易的最低价格波动百分比（5%）
max_position	5.0	SIMMER_SPRINT_MAX_POSITION	单次交易的最大金额（5美元）
signal_source	binance	SIMMER_SPRINT SIGNAL	价格数据源（Binance或coingecko）
lookback_minutes	5	SIMMER_SPRINT_lookBACK	价格历史数据保留时长（分钟）
min_time_remaining	60	SIMMER_SPRINT_MIN_TIME	跳过剩余时间不足60秒的快速市场
asset	BTC	SIMMER_SPRINT_ASSET	交易资产（BTC、ETH或SOL）
window	5m	SIMMER_SPRINT_WINDOW	交易窗口时长（5分钟或15分钟）
volume_confidence	true	SIMMER_SPRINT_VOL_CONF	是否根据Binance的交易量加权信号

示例config.json文件

{
  "entry_threshold": 0.08,
  "min_momentum_pct": 0.3,
  "max_position": 10.0,
  "asset": "BTC",
  "window": "5m",
  "signal_source": "binance"
}

命令行参数

python fastloop_trader.py                    # Dry run
python fastloop_trader.py --live             # Real trades
python fastloop_trader.py --live --quiet     # Silent except trades/errors
python fastloop_trader.py --smart-sizing     # Portfolio-based sizing
python fastloop_trader.py --positions        # Show open fast market positions
python fastloop_trader.py --config           # Show current config
python fastloop_trader.py --set KEY=VALUE    # Update config

信号逻辑

默认信号（Binance价格波动）：

1. 从Binance获取过去5分钟的每分钟价格数据（以BTCUSDT计）
2. 计算价格波动率：(current_price - price_5min_ago) / price_5min_ago
3. 比较当前价格波动率与Polymarket的市场价格走势
4. 当满足以下条件时执行交易：
   • 价格波动率 ≥ min_momentum_pct（默认为0.5%）
   • 价格波动幅度 ≥ entry_threshold（默认为5美分）
   • 交易量超过平均交易量的1.5倍（排除价格波动较小的情况）

示例：如果过去5分钟内BTC价格上涨了0.8%，但快速交易市场的实际价格仅为0.52美元，且价格与预期价格（约0.55美元）相差3美分，则触发买入信号。

自定义信号

**此技能提供了一个模板。**默认的Binance价格波动信号仅作为参考。您可以根据自己的需求替换为其他信号源。**自定义信号的建议包括：

• 多交易所价格对比：比较Binance、Kraken、Bitfinex等交易所的价格差异，以预测价格走势
• 市场情绪分析：结合Twitter或社交媒体上的实时信息，这些信息可能影响快速交易市场的价格波动
• 技术指标：使用RSI、VWAP等指标进行分析
• 新闻事件：利用新闻事件来预测价格走势
• 链上数据：关注大额交易者的行为、资金流动情况等

要自定义信号逻辑，可以修改fastloop_trader.py文件中的get_momentum()函数或添加自己的信号处理函数。其余部分（市场发现、数据导入、交易规模控制等）保持不变。

示例交易结果

⚡ Simmer FastLoop Trading Skill
==================================================

  [DRY RUN] No trades will be executed. Use --live to enable trading.

⚙️  Configuration:
  Asset:            BTC
  Entry threshold:  0.05 (min divergence from 50¢)
  Min momentum:     0.5% (min price move)
  Max position:     $5.00
  Signal source:    binance
  Lookback:         5 minutes
  Min time left:    60s
  Volume weighting: ✓

🔍 Discovering BTC fast markets...
  Found 3 active fast markets

🎯 Selected: Bitcoin Up or Down - February 15, 5:30AM-5:35AM ET
  Expires in: 185s
  Current YES price: $0.480

📈 Fetching BTC price signal (binance)...
  Price: $97,234.50 (was $96,812.30)
  Momentum: +0.436%
  Direction: up
  Volume ratio: 1.45x avg

🧠 Analyzing...
  ⏸️  Momentum 0.436% < minimum 0.500% — skip

📊 Summary: No trade (momentum too weak: 0.436%)

数据标记

所有交易都会被标记为source: "sdk:fastloop"。这意味着：

• 投资组合会按策略进行分类显示
• 其他技能不会影响快速交易的结果
• 您可以单独查看快速交易的盈亏情况

常见问题及解决方法

• “未找到活跃的快速交易市场”：可能是因为当前市场处于非交易时间或周末
• 请直接在Polymarket网站上查看是否有活跃的BTC快速交易市场
• “剩余时间少于60秒时未找到快速交易市场”：当前交易窗口即将结束，下一个交易窗口尚未开放
• 如果希望更频繁地进行交易，请减小min_time_remaining的值
• “数据导入失败：超出请求限制”：免费账户每天最多只能导入10次数据；专业账户每天最多50次
• “无法获取价格数据”：可能是Binance API暂时不可用或受到请求限制
• 可尝试使用--set signal_source=coingecko作为备用数据源
• “交易失败：市场流动性不足”：快速交易市场中的交易量较小，建议减小交易规模
• “外部钱包需要预签名订单”：确保环境变量WALLET_PRIVATE_KEY已设置正确
  • SDK会自动签名交易订单，无需手动操作
• 解决方法：设置export WALLET_PRIVATE_KEY=0x<your-polymarket-wallet-private-key>
• 请勿尝试手动签名订单或修改脚本代码，SDK会自动处理这些操作
• “账户余额显示为0美元，但实际上我有资金”：Polymarket V2版本（2026年4月28日起）使用的是pUSD（由USDC.e支持）。如果您的钱包中持有USDC.e，请访问simmer.markets/dashboard进行迁移（大约需要30秒）
  • 如果您使用的是Circle平台的USDC，请先将其转换为USDC.e，再迁移至pUSD
  • 完整迁移指南：docs.simmer.markets/v2-migration