Polymarket 天气交易员

使用 NOAA 预报数据在 Polymarket 上交易温度市场。

这是一个模板。默认信号是 NOAA 温度预报——您可以将其与其他天气 API、不同的预报模型或额外的市场类型（降水、风力等）进行混合定制。该技能处理所有底层管道工作（市场发现、NOAA 数据解析、交易执行、安全防护）。您的代理提供核心策略。

何时使用此技能

当用户想要：

• 自动交易天气市场
• 设置类似 gopfan2 风格的温度交易
• 低价买入天气预测
• 查看其天气交易持仓
• 配置交易阈值或地点

v1.14.0 版本的新内容

• 修复了环境变量名称以匹配自动调优注册表（旧名称仍可作为别名使用）：
  • SIMMER_WEATHER_ENTRY→SIMMER_WEATHER_ENTRY_THRESHOLD
  • SIMMER_WEATHER_EXIT→SIMMER_WEATHER_EXIT_THRESHOLD
  • SIMMER_WEATHER_MAX_POSITION→SIMMER_WEATHER_MAX_POSITION_USD
  • SIMMER_WEATHER_MAX_TRADES→SIMMER_WEATHER_MAX_TRADES_PER_RUN
• 新增可调参数：SIMMER_WEATHER_SLIPPAGE_MAX— 可调节的滑点保护（默认 15%）。在流动性差的市场进行研究模式时，可设置更高值。
• 新增可调参数：SIMMER_WEATHER_MIN_LIQUIDITY— 跳过流动性低于此美元阈值的市场（默认 0 = 禁用）。在执行前预先过滤流动性不足的市场。
• SIMMER_WEATHER_LOCATIONS和SIMMER_WEATHER_BINARY_ONLY现已作为自动调优可调参数公开。

v1.13.0

• 仅二元模式：新增SIMMER_WEATHER_BINARY_ONLY配置以跳过范围桶事件（例如"纽约市 34-35°F"），仅交易二元是/否天气市场

v1.2.0

• 每次运行最大交易数量: 新增SIMMER_WEATHER_MAX_TRADES用于限制每次扫描周期的交易数量（默认值：5）

v1.1.1

• 状态脚本: 新增scripts/status.py用于快速检查余额和持仓情况
• API 参考: 新增了包含 API 端点的快速命令部分

v1.1.0

• 来源标记: 所有交易均标记为sdk:weather以便进行投资组合跟踪
• 智能头寸规模调整: 基于可用余额的头寸规模调整（--smart-sizing）
• 上下文安全防护检查是否存在反复无常的警示、价格滑点、时间价值衰减
• 价格趋势检测：检测近期价格下跌以获取更强信号

设置流程

当用户要求安装或配置此技能时：

1. 询问Simmer API密钥

   • 用户可从simmer.markets/dashboard → SDK选项卡获取
   • 存储至环境变量SIMMER_API_KEY

2. 询问钱包私钥（实盘交易必需）

   • 此为Polymarket钱包私钥（存放USDC的钱包）
   • 存储至环境变量WALLET_PRIVATE_KEY
   • SDK将自动使用此私钥在客户端签署订单——无需手动签名

3. 询问设置选项（或确认默认值）

   • 入场阈值：买入时机（默认15美分）
   • 离场阈值：卖出时机（默认45美分）
   • 最大持仓：每笔交易金额（默认2.00美元）
   • 地点：在哪些城市进行交易（默认纽约）

4. 将设置保存到环境变量

5. 设置定时任务（默认禁用——用户必须启用调度功能）

配置

旧版环境变量别名（出于向后兼容性考虑，目前仍被接受）：SIMMER_WEATHER_ENTRY,SIMMER_WEATHER_EXIT,SIMMER_WEATHER_MAX_POSITION,SIMMER_WEATHER_MAX_TRADES

支持的地点：纽约市、芝加哥、西雅图、亚特兰大、达拉斯、迈阿密

快捷命令

# 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

运行技能

# Dry run (default — shows opportunities, no trades)
python weather_trader.py

# Execute real trades
python weather_trader.py --live

# With smart position sizing (uses portfolio balance)
python weather_trader.py --live --smart-sizing

# Check positions only
python weather_trader.py --positions

# View config
python weather_trader.py --config

# Disable safeguards (not recommended)
python weather_trader.py --no-safeguards

# Disable trend detection
python weather_trader.py --no-trends

# Quiet mode — only output on trades/errors (ideal for high-frequency runs)
python weather_trader.py --live --quiet

# Combine: frequent scanning, minimal noise
python weather_trader.py --live --smart-sizing --quiet

工作原理

每个周期脚本会：

1. 从Simmer API获取活跃的天气市场
2. 按事件对市场进行分组（每个温度日为一个事件）
3. 解析事件名称以获取地点和日期
4. 获取该地点/日期的NOAA天气预报
5. 找到与预报匹配的温度区间
6. 安全防护：检查上下文中的反复波动警告、滑点、时间衰减
7. 趋势检测：寻找近期价格下跌（更强的买入信号）
8. 入场：若区间价格 < 阈值且通过安全防护 → 买入
9. 出场：检查未平仓头寸，若价格 > 出场阈值则卖出
10. 标记：所有交易均标记为sdk:weather以便追踪

智能头寸规模管理

使用--smart-sizing参数时，头寸规模计算公式为：

• 可用USDC余额的5%（可通过SIMMER_WEATHER_SIZING_PCT)
• 受限于最大持仓设置（默认 $2.00）
• 若投资组合不可用，则回退至固定规模

这可以防止过度部署，并根据您的账户规模进行缩放。

安全防护措施

交易前，该技能会检查：

• 反复无常警告：若您频繁反转方向，则跳过交易
• 滑点：若预估滑点 > 15%，则跳过交易
• 时间衰减：若市场在 < 2 小时内结算，则跳过交易
• 市场状态：若市场已结算，则跳过交易

可通过以下方式禁用--no-safeguards（不推荐）。

来源标记

所有交易均标记有来源："sdk:weather"。这意味着：

• 投资组合按策略细分
• 跟单技能不会出售您的天气仓位
• 您可以单独追踪天气交易的盈亏

示例输出

🌤️ Simmer Weather Trading Skill
==================================================

⚙️ Configuration:
  Entry threshold: 15% (buy below this)
  Exit threshold:  45% (sell above this)
  Max position:    $2.00
  Locations:       NYC
  Smart sizing:    ✓ Enabled
  Safeguards:      ✓ Enabled
  Trend detection: ✓ Enabled

💰 Portfolio:
  Balance: $150.00
  Exposure: $45.00
  Positions: 8

📍 NYC 2026-01-28 (high temp)
  NOAA forecast: 34°F
  Matching bucket: 34-35°F @ $0.12
  💡 Smart sizing: $2.00 (capped at max position)
  ✅ Below threshold ($0.15) - BUY opportunity! 📉 (dropped 15% in 24h)
  Executing trade...
  ✅ Bought 62.5 shares @ $0.12

📊 Summary:
  Events scanned: 12
  Entry opportunities: 1
  Trades executed: 1

故障排除

"安全防护已阻止：严重频繁转向警告"

• 您在该市场的交易方向变动过于频繁
• 请等待一段时间后再进行交易

"滑点过高"

• 市场流动性不足，请减小仓位规模或跳过交易

"X小时内将结算 - 为时过早"

• 市场即将结算，风险升高

"未找到天气市场"

• 天气市场可能未开放（季节性）

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

• 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，然后重试

"API密钥无效"

• 请从simmer.markets/dashboard → SDK标签页获取新密钥