工作原理： 每个周期内，脚本会查找当前活跃的 BTC 快速市场，检查币安上 BTC 的价格动量，并在动量方向与市场赔率出现背离时发起交易。

这是一个模板。 默认信号（币安动量）可助您快速上手。您代理（agent）的推理能力才是核心优势 —— 可叠加情绪分析、多交易所价差、新闻流或自定义信号来提升策略表现。

⚠️ 快速市场收取 Polymarket 的 10% 手续费（is_paid: true）。请在计算盈利优势（edge）时计入此项成本。

适用场景

当用户希望实现以下目标时，请使用该技能：

• 交易 BTC 短线/快速市场（5 分钟或 15 分钟）
• 自动化短期加密货币预测交易
• 将中心化交易所（CEX）价格动量作为 Polymarket 交易信号
• 监控短线市场持仓

配置流程

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

1. 索取 Simmer API 密钥

   • 获取方式：访问 simmer.markets/dashboard → SDK 标签页
   • 以环境变量形式存储为 SIMMER_API_KEY

2. 确认配置项（或采用默认值）

   • 标的资产：BTC、ETH 或 SOL（默认 BTC）
   • 入场阈值：触发交易所需的最小价格偏离（默认 5 美分）
   • 最大单笔仓位：每笔交易金额上限（默认 $5.00）
   • 市场窗口：5m 或 15m（默认 5m）

3. 配置定时任务或循环机制（调度由用户自主控制 — 参见“如何循环运行”）

快速启动

# 设置您的 API 密钥
export SIMMER_API_KEY="your-key-here"

# 模拟运行 — 查看将发生什么
python fastloop_trader.py

# 实盘运行
python fastloop_trader.py --live

# 实盘 + 静默模式（适用于 cron / 心跳循环）
python fastloop_trader.py --live --quiet

# 实盘 + 智能仓位（每笔交易占账户余额的 5%）
python fastloop_trader.py --live --smart-sizing --quiet

如何循环运行

该脚本每次仅执行一个周期 —— 循环逻辑由您的 bot 控制。请设置 cron 任务或心跳机制：

每 5 分钟一次（每个快速市场窗口执行一次）：

*/5 * * * * cd /path/to/skill && python fastloop_trader.py --live --quiet

每 1 分钟一次（更激进，可捕捉窗口中期机会）：

* * * * * cd /path/to/skill && python fastloop_trader.py --live --quiet

通过 OpenClaw 心跳机制运行： 在您的 HEARTBEAT.md 中添加如下行：

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

配置方式

可通过 config.json、环境变量或 --set 参数进行配置：

# 修改入场阈值
python fastloop_trader.py --set entry_threshold=0.08

# 交易 ETH 而非 BTC
python fastloop_trader.py --set asset=ETH

# 同时设置多个参数
python fastloop_trader.py --set min_momentum_pct=0.3 --set max_position=10

配置项说明

示例 config.json

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

CLI 命令选项

python fastloop_trader.py                    # 模拟运行
python fastloop_trader.py --live             # 实盘交易
python fastloop_trader.py --live --quiet     # 仅输出交易和错误信息（静默模式）
python fastloop_trader.py --smart-sizing     # 基于账户总资金动态调整仓位
python fastloop_trader.py --positions        # 显示当前未平仓的快速市场仓位
python fastloop_trader.py --config           # 显示当前配置
python fastloop_trader.py --set KEY=VALUE    # 更新配置项

信号逻辑

默认信号（币安动量）：

1. 从币安拉取最近 5 根 BTCUSDT 一分钟 K 线
2. 计算动量： (当前价格 - 5 分钟前价格) / 5 分钟前价格
3. 将动量方向与当前 Polymarket 市场赔率方向对比
4. 满足以下全部条件时触发交易：
   • 动量 ≥ min_momentum_pct（默认 0.5%）
   • 价格偏离 50 美分 ≥ entry_threshold（默认 5 美分）
   • 成交量比率 > 平均值的 0.5 倍（过滤低流动性微小波动）

示例： BTC 过去 5 分钟上涨 0.8%，但快速市场 YES 报价仅为 $0.52。预期价格约为 $0.55，存在 3 美分偏离 → 买入 YES。

自定义信号

默认动量信号仅为起点。如需构建专属优势，请尝试以下扩展方向：

• 多交易所比价： 对比币安、Kraken、Bitfinex 等平台价格 —— 交易所间价差可预示中心化订单簿（CLOB）走向
• 情绪分析： 整合 Twitter/社交媒体信号 —— 爆款推文可能显著影响快速市场
• 技术指标： RSI、VWAP、订单流分析等
• 新闻驱动： 关联突发新闻事件 —— 利用您的 agent 推理能力解读新闻标题

该技能已封装全部 Simmer 底层逻辑（市场发现、合约导入、交易执行）。您的 agent 提供的是真正的 Alpha。

示例输出

⚡ 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"。这意味着：

• 投资组合页面可按策略维度查看持仓分解
• 其他技能不会干扰您在快速市场的持仓
• 可独立追踪快速市场盈亏（P&L）

故障排查

“未找到活跃的快速市场”

• 快速市场可能尚未开启（非交易时段、周末等）
• 请直接访问 Polymarket 确认是否存在活跃的 BTC 快速市场

“未找到剩余时间超过 60 秒的快速市场”

• 当前窗口即将到期，下一窗口尚未上线
• 如需更接近到期时间交易，可调低 min_time_remaining

“导入失败：超出速率限制”

• 免费版：每日最多 10 次导入；Pro 版：每日最多 50 次
• 高频快速市场交易建议使用 Pro 版

“无法获取价格数据”

• 币安 API 可能暂时不可用或触发了速率限制
• 可尝试备用数据源：--set signal_source=coingecko

“交易失败：无流动性”

• 快速市场深度不足，建议减小单笔交易规模