Kalshi 天气交易员

通过 Solana 上的 DFlow，利用 NOAA 天气预报数据在 Kalshi 交易气温类预测市场。

🚨 本项目为框架性质，非可用于实盘交易的生产系统。 在连接含真实资金的钱包前，请务必阅读 DISCLAIMER.md。

这是一个模板。 默认信号源为 NOAA 气温预报 —— 你可以将其改造成接入其他天气 API、采用不同预报模型，或扩展至其他气象市场类型（如降水、风速等）。该技能已封装全部底层逻辑（市场发现、NOAA 数据解析、交易执行、风控机制），你的智能体只需提供核心策略（alpha）。

由 DFlow 提供支持。 Kalshi 交易通过 DFlow 基于 Solana 的预测市场基础设施执行。买入操作需完成 Proof 平台的 KYC 实名认证。

适用场景

当用户希望执行以下操作时，可使用本技能：

• 在 Kalshi（而非 Polymarket）交易天气类预测市场
• 在 Kalshi 自动化交易气温相关合约
• 查询其 Kalshi 天气交易持仓情况
• 配置交易阈值或目标城市

安装与配置流程

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

1. 安装 Simmer SDK

   pip install simmer-sdk
   

2. 获取 Simmer API 密钥

   • 可在 simmer.markets/dashboard → SDK 标签页中获取
   • 请将其存入环境变量 SIMMER_API_KEY

3. 提供 Solana 私钥（实盘交易必需）

   • 即其 Solana 钱包的 base58 编码私钥
   • 请将其存入环境变量 SOLANA_PRIVATE_KEY
   • SDK 将自动在客户端使用该密钥签名交易

4. 完成 KYC 认证

   • 仅买入操作需要 KYC（卖出无需）
   • 请访问 dflow.net/proof 完成认证
   • 检查认证状态：curl "https://api.simmer.markets/api/proof/status?wallet=YOUR_SOLANA_ADDRESS"

5. 为钱包充值

   • Solana 主网 SOL（用于支付交易手续费，约 0.01 SOL）
   • Solana 主网 USDC（用于交易本金）

6. 确认或设置参数（或接受默认值）

   • 入场阈值：触发买入的价格（默认 15¢）
   • 离场阈值：触发卖出的价格（默认 45¢）
   • 单笔最大仓位：每笔交易金额上限（默认 $2.00）
   • 目标城市：参与交易的城市列表（默认 NYC）

7. 将配置保存为环境变量

8. 配置定时任务（cron）（默认禁用 — 用户需手动启用调度）

配置项

支持的城市： NYC、Chicago、Seattle、Atlanta、Dallas、Miami

快捷命令

# 查询账户余额及持仓
python scripts/status.py

# 查看详细持仓列表
python scripts/status.py --positions

API 参考：

• 基础 URL：https://api.simmer.markets
• 认证方式：Authorization: Bearer $SIMMER_API_KEY
• 账户组合：GET /api/sdk/portfolio
• 持仓信息：GET /api/sdk/positions

运行技能

# 模拟运行（默认模式 — 显示交易机会，不实际下单）
python weather_trader.py

# 执行实盘交易
python weather_trader.py --live

# 启用智能仓位管理（基于账户余额动态计算仓位）
python weather_trader.py --live --smart-sizing

# 仅查询持仓
python weather_trader.py --positions

# 查看当前配置
python weather_trader.py --config

# 静默模式 — 仅在发生交易或报错时输出日志（适用于高频运行场景）
python weather_trader.py --live --smart-sizing --quiet

工作原理

每次运行周期中，脚本将执行以下步骤：

1. 从 Simmer API 获取当前活跃的天气类市场
2. 按事件对市场进行分组（每个气温预测日期视为一个独立事件）
3. 解析事件名称，提取地理位置与日期信息
4. 获取对应地点与日期的 NOAA 天气预报数据
5. 匹配预报温度值所属的温度区间（bucket）
6. 风控检查：验证是否存在频繁反向操作警告、滑点是否超标、时间衰减是否严重
7. 趋势识别：检测近期价格是否出现明显下跌（强化买入信号）
8. 入场逻辑：若匹配 bucket 的市场价格低于入场阈值且所有风控检查通过 → 执行 BUY
9. 离场逻辑：检查当前未平仓头寸，若市场价格高于离场阈值 → 执行 SELL
10. 交易标记：所有交易均打上 sdk:kalshi-weather 标签以便追踪

风控机制

交易前，技能将检查以下条件：

• 频繁反向操作警告：若近期在同一市场反复买卖，则跳过
• 滑点超限：若预估滑点 > 15%，则跳过
• 时间衰减过快：若市场距结算时间不足 2 小时，则跳过
• 市场状态异常：若市场已结算，则跳过
• Kalshi 系统维护：Kalshi 清算所每周四凌晨 3:00–5:00（美国东部时间）进行例行维护 —— 此期间提交的订单将失败

可通过 --no-safeguards 参数禁用全部风控（不推荐）。

故障排查

“风控拦截：严重频繁反向操作警告”

• 您在该市场上的买卖方向切换过于频繁
• 建议等待一段时间后再尝试交易

“滑点过高”

• 该市场流动性不足，可考虑降低单笔仓位或跳过该市场

“未找到天气类市场”

• 天气类市场可能暂未开放（存在季节性）
• 请先确保已导入 Kalshi 天气市场：POST /api/sdk/markets/import/kalshi

“需完成 KYC 认证”

• 请访问 dflow.net/proof 完成认证
• 仅买入操作需要 KYC，卖出无需

“SOLANA_PRIVATE_KEY 未设置”

• SDK 在该环境变量存在时会自动完成交易签名
• 修复方法：export SOLANA_PRIVATE_KEY=

“SOL 余额不足以支付交易手续费”

• 请为您的 Solana 钱包充值至少 0.05 SOL 作为 Gas 费

“API 密钥无效”

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