calci-prediction-market

Calci 预测市场（Kalshi）

Calci 的预测市场层基于 Kalshi 构建。此技能提供了理解 Calci/Kalshi 数据并向用户清晰说明所需的领域模型、交易机制和 API 约定。

核心认知模型

1. 二元事件合约

   • 每份可交易合约都针对现实世界中的某个结果，分为 Yes/No。
   • 获胜方支付 $1，失败方支付 $0。
   • $0.01–$0.99 之间的价格表示隐含概率。

2. 隐含概率

   • 如果 Yes 合约的交易价格为 $0.74，市场隐含 Yes 的概率约为 74%。
   • No 价格与之互补（大致为 1 − Yes，不考虑费用/价差）。

3. 全额抵押

   • 用户预先支付最大可能亏损金额。不使用保证金或杠杆。
   • 合约损失永远不会超过你的支出。

数据层级（Kalshi → Calci）

Kalshi 使用严格的层级结构：

• Series（系列） → 定期重复市场的模板（共用规则/结算方式）。
• Event（事件） → 系列中的具体实例（现实世界中发生的事件）。
• Market（市场） → 事件中的单个二元合约（一个 Yes/No 结果）。

Calci 镜像了这些对象。在 Calci UI 中看到“市场”时，请明确它指的是事件页面（容器），还是特定市场结果（二元合约一侧）。

市场对象：字段含义

解读 Calci/Kalshi 市场 JSON 时：

• ticker：唯一标识符（字符串）。
• event_ticker / series_ticker：父级标识符。
• title / subtitle：易于理解的问题及说明。
• yes_bid / yes_ask（美分）和 _dollars：买入/卖出 Yes 的最佳价格。
• no_bid / no_ask：买入/卖出 No 的最佳价格。
• last_price：Yes 的最近成交价。
• volume / volume_24h / open_interest：交易活动和未平仓合约数量。
• open_time / close_time / expiration_time：生命周期时间戳。
• status：已初始化、活跃/开放、已关闭、已结算。
• result / settlement_value：结果确定后设置。

需要说明的交易机制

• Yes 和 No 两侧均设有订单簿。
• 快捷单/市价单会穿过当前价差，以立即成交。
• 限价单以指定价格挂单；可能增加流动性。
• 平仓 = 之后采取相反方向的操作（卖出 Yes 或买入 No）。
• 互斥事件包含多个市场，其中最多只有一个市场可以结算为 Yes。

Kalshi 的费用可变且呈二次函数关系，约为潜在利润的百分之一；做市订单可能享有折扣。

结算与结果判定

• 每个系列都会规定官方结算来源和规则。
• 市场通常会在触发条件/决策时间之前关闭，并在确认后结算。
• 如果 can_close_early 为 true，部分市场可能提前确定结果。

当用户询问“结果如何判定？”时，请参考系列规则和结算来源，再用通俗语言重述。

应遵循的 API 约定

公开数据（无需身份验证）：

• GET /series
• GET /events（事件包含其市场）
• GET /markets
• GET /market/{ticker}
• GET /market/orderbook
• GET /market/candlesticks
• GET /market/trades
• GET /exchange/status

交易/账户（需要身份验证）：

• POST /orders、DELETE /orders/{id}、GET /orders/{id}
• POST /order-groups 及相关订单组端点
• GET /portfolio/balance、GET /portfolio/positions、GET /portfolio/fills

身份验证使用 API 密钥 ID 和 RSA 签名请求头：

• KALSHI-ACCESS-KEY
• KALSHI-ACCESS-TIMESTAMP
• KALSHI-ACCESS-SIGNATURE

实时更新通过订阅 ticker 的 WebSocket 接收。

回答时如何应用此技能

1. 如果用户表述含糊，将 Calci 术语映射为 Kalshi 术语。
2. 始终区分 Series、Event 和 Market，并重申讨论的是哪个层级。
3. 在有帮助时，明确将价格转换为概率。
4. 讨论定价或订单簿时，说明 Yes/No 双方以及价差。
5. 对于结算问题，引用规则和结算来源。
6. 保持中立：说明机制和风险；不要提供财务建议。

示例

• “这个 Calci 市场是 Kalshi 的一个 market ticker。它是一个二元合约，如果 Yes，赔付 1 美元。价格为 0.62 美元时，市场隐含的 Yes 概率约为 62%。”
• “该事件的结果互斥，因此每个候选结果都是一个单独的市场。最终恰好只有一个结果可以结算为 Yes。”
• “要获取实时价格，请通过 Kalshi WebSocket 订阅市场代码；Calci 会同步这些更新。”

更多详情，请参阅 reference.md。