Horizon SDK

📈 预测市场量化交易与风控引擎

Horizon Trader 是面向预测市场(Polymarket、Kalshi)的专业量化交易工具,支持 Kelly 最优仓位、蒙特卡洛风控、跨平台套利及 Greeks 等衍生品分析,适合具备一定金融工程背景的活跃交易者。

收藏
3.5k
安装
1.4k
版本
0.5.4
CLS 安全性认证2026-07-19
点击查看完整报告 >

使用说明

核心用法

Horizon Trader 通过 CLI 脚本 horizon.py 提供完整的预测市场交易能力,涵盖以下场景:

账户与交易管理:实时查询持仓、盈亏、未成交订单;提交限价单(价格以 0-1 概率区间表示);批量撤单或针对特定市场操作;支持"紧急停止"(kill-switch)一键平仓。

市场发现与数据:搜索 Polymarket/Kalshi 市场(支持二进制/多结果事件分类);获取单市场深度数据;追踪热门市场成交量排行。

量化分析与风控

  • Kelly 公式:计算最优仓位规模,支持分数 Kelly 与上限约束
  • 蒙特卡洛模拟:对当前持仓进行 50000+ 次情景模拟,评估组合风险
  • VaR/CVaR:Cornish-Fisher 修正后的风险价值计算
  • 预测 Greeks:Delta、Gamma、Theta、Vega 针对二元市场的特殊推导
  • 压力测试:相关性飙升、流动性枯竭、尾部风险等极端情景

跨平台套利:原子级执行跨交易所价差套利(如 Kalshi 买入/Polymarket 卖出)。

钱包分析(无需私钥):任意地址的交易历史、持仓分布、盈亏统计、头部持有者追踪、资金流向分析。

高级功能:实时数据馈送(Chainlink 预言机、PredictIt、Manifold、ESPN、NWS 天气);TWAP/VWAP/Iceberg 执行算法;隐马尔可夫模型(HMM) regime 检测;微观结构指标(Kyle's Lambda、Amihud、Roll Spread 等)。

显著优点

1. 机构级风控框架:内置 kill-switch、止损/止盈条件单、持仓偏斜调整、自适应价差,形成完整的风控闭环
2. 数学严谨性:Kelly 仓位、Cornish-Fisher VaR、deflated Sharpe 等指标均经过统计校正,避免过拟合

3. 多源数据整合:原生支持 8+ 种数据馈送,包括链上预言机、体育比分、天气预报等非传统信号源

4. 无许可分析能力:钱包分析功能无需 API 密钥即可追踪任意地址,适合研究对手方行为

5. 回测基础设施:L2 订单簿回放、多种成交模型(deterministic/probabilistic/GLFT)、延迟模拟

潜在缺点与局限性

  • 学习曲线陡峭:需要熟悉概率定价、Greeks 计算、统计指标等金融工程概念
  • 依赖中心化 API:核心交易功能需 HORIZON_API_KEY,存在供应商锁定风险
  • 预测市场流动性局限:Polymarket/Kalshi 深度有限,大额订单可能显著冲击价格
  • 地区合规风险:预测市场在美国部分州受限,跨境套利可能触及监管灰色地带
  • 预言机延迟:Chainlink 等链上喂价存在区块确认延迟,极端行情下可能滞后

适合人群

  • 量化交易员、做市商(MM)策略开发者
  • 预测市场活跃流动性提供者
  • 金融工程研究者、对冲基金分析师
  • 套利交易者(具备跨平台资金调度能力)

常规风险

| 风险类型 | 说明 |
|---------|------|
| 交易执行风险 | `quote` 命令直接提交真实订单,需二次确认 |
| 模型风险 | Kelly 公式假设已知真实概率,实际估计误差可能导致爆仓 |
| 技术风险 | kill-switch 依赖本地运行状态,进程崩溃可能失效 |
| 合规风险 | 预测市场在美国受限地区可能被清退,资金冻结 |
| 预言机风险 | REST/Chainlink 喂价故障可能导致策略误触发 |

安全解读

Horizon Trader 综合评估

核心用法

Horizon Trader 是一款面向预测市场(Prediction Markets)的专业级量化交易工具,主要对接 PolymarketKalshi 两大主流平台。用户通过 CLI 脚本调用 horizon.py 执行各类交易操作,所有交互返回 JSON 格式数据。

主要功能模块

1. 账户与持仓管理

  • status / positions / orders / fills:实时查看引擎状态、持仓、挂单和成交记录
  • wallet-* 系列命令:分析任意 Polymarket 钱包的交易历史、持仓价值、公开资料

2. 交易执行

  • quote:提交限价单(支持 buy/sell、yes/no 双边方向)
  • cancel / cancel-all / cancel-market:灵活撤单
  • 支持 paper trading(模拟)和真实交易两种模式

3. 市场发现与研究

  • discover:按关键词、类型(binary/multi)、类别(crypto/politics/sports)搜索市场
  • market-detail / top-markets:获取市场深度信息和成交量排行
  • market-flow / top-holders:资金流向分析与大户持仓追踪

4. 量化风控与策略

  • Kelly Sizing:基于概率优势计算最优仓位(支持 fractional Kelly、最大仓位限制)
  • 蒙特卡洛模拟simulate / stress-test 评估组合风险
  • 预测希腊字母:Delta/Gamma/Theta/Vega 用于二元期权风格的风险敞口管理
  • 止损/止盈stop-loss / take-profit 条件单自动化风控

5. 高级分析工具

  • 信息论指标:熵、KL 散度、互信息
  • 市场微观结构:Kyle's Lambda、Amihud 流动性比率、Roll 价差
  • 统计检验:Hurst 指数、方差比率、Deflated Sharpe Ratio
  • 执行算法:TWAP、VWAP、Iceberg 大单拆分

6. 实时数据 Feed

  • 内置 Polymarket、Kalshi、Chainlink、PredictIt、Manifold Markets 价格源
  • 扩展支持 ESPN(体育比分)、NWS(天气预报)等外部信号

---

显著优点

| 维度 | 亮点 |
|------|------|
| **策略深度** | 罕见的将机构级量化工具(Kelly、Monte Carlo、Greeks、CPCV回测)引入预测市场零售场景 |
| **风控体系** | Kill Switch 紧急制动、条件单、实时 feed 健康监控、库存倾斜动态调仓 |
| **跨市场套利** | 原生支持 `arb` 命令执行跨交易所(Kalshi ↔ Polymarket)的原子套利 |
| **透明度** | 钱包分析功能无需 API 密钥即可查询任意地址,便于链上研究 |
| **回测能力** | L2 订单簿级模拟、多种成交模型(deterministic/probabilistic/GLFT)、延迟模拟 |
| **模块化设计** | Pipeline 架构支持信号组合、马尔可夫状态切换、多策略并行运行 |

---

潜在缺点与局限性

使用门槛

  • 专业术语密集:Hurst 指数、Deflated Sharpe、CPCV 等概念对非量化背景用户构成认知障碍
  • 配置复杂:需理解 HORIZON_API_KEYHORIZON_EXCHANGE 环境变量、Chainlink RPC 节点等基础设施

功能边界

  • 地域限制:Polymarket/Kalshi 在美国部分州受限,用户需自行确认合规性
  • 流动性风险:小众预测市场价差大、滑点高,量化策略的实际执行效果可能偏离理论值
  • 预言机依赖:Chainlink feed 的配置需要用户自行提供 RPC,存在节点可用性风险

技术债务

  • T3 来源等级:来自 OpenClaw 生态的个人开发者项目,未在 GitHub 开源,透明度有限
  • 外部 API 依赖: Horizon SDK 为闭源/托管服务,长期可维护性依赖单一供应商
  • 无图形界面:纯 CLI 工具,对习惯可视化交易的用户不够友好

---

适合人群

| 用户画像 | 匹配度 |
|----------|--------|
| **量化交易员/对冲基金研究员** | ⭐⭐⭐⭐⭐ 需要回测框架和希腊字母风控 |
| **Polymarket 活跃做市商** | ⭐⭐⭐⭐⭐ 跨市场套利、自动报价、库存管理 |
| **数据科学家** | ⭐⭐⭐⭐☆ 丰富的微观结构指标和信号诊断工具 |
| **预测市场研究者** | ⭐⭐⭐⭐☆ 钱包分析、资金流向、市场效率测试 |
| **普通散户** | ⭐⭐☆☆☆ 学习曲线陡峭,建议从平台原生界面入门 |

---

常规风险

1. 资金安全风险quote 命令可提交真实订单,误操作可能导致实际损失;务必先用 paper trading 验证策略
2. API 密钥泄露HORIZON_API_KEY 需妥善保管,避免提交至版本控制或共享环境

3. 模型风险:Kelly 公式、蒙特卡洛模拟均基于历史概率估计,无法预测黑天鹅事件

4. 执行风险:条件单(stop-loss/take-profit)依赖 feed 健康度,极端行情下可能触发延迟或失效

5. 合规风险:预测市场在部分司法管辖区属灰色地带,用户需自行承担法律后果

6. 技术故障风险:Kill Switch 虽可紧急制动,但无法保证 100% 阻断极端网络延迟或 API 异常

Horizon SDK 内容

scripts文件夹
手动下载zip · 11.3 kB
horizon.pytext/plain
请选择文件