Skip to content

结算数据

Kalshi 与 Polymarket 各自制定结算规则。这篇文档说明如何用同一个接口把两边的规则并排读出来。

GET /v2/pairs/{market_id}/settlement返回一个已匹配市场对的身份信息与结算视图，不携带价格数据。响应中包含两个平台的结算规则是否一致、已披露的分歧风险、每个平台各自公开的结算条款原文，以及市场结算后双方是否一致的判定。

为什么结算条款要并排读

两个平台，两套规则。同一场因故延期的比赛，一个平台可能等到补赛打完才结算，另一个平台却把合约一直挂着不结算。一次弃权判罚，一个平台可能判给某一方获胜，另一个平台却按五五分成处理。就连再普通不过的平局，也可能让同时持有两边合约的仓位措手不及，如果只有一个平台在规则里写明了平局作废条款。跨平台价差要真正算得上一个干净的价差机会，前提是两条腿最终都能按同样的方式兑付，这正是在判断一个价差能不能交易之前，需要先读结算字段的原因。

获取结算数据

路径参数支持与 GET /v2/pairs/{market_id} 完全相同的三种写法：规范的dino_<uuid>、裸 UUID，或市场分配到的 slug。相比一串 UUID，slug 在日志和后台里读起来更直观，在这个接口上的解析方式与 id 完全一样。

curl -s "https://api.dino.markets/v2/pairs/nyy-vs-bos-2026-08-01/settlement" \
  -H "Authorization: Bearer sk_live_..."
{
  "id": "dino_9b1e2c34-5f6a-4d7e-8b9c-0a1b2c3d4e5f",
  "slug": "nyy-vs-bos-2026-08-01",
  "title": "Nyy vs Bos",
  "status": "resolving",
  "settlement": {
    "parity": false,
    "risks": [
      {
        "event": "forfeit_unverified",
        "severity": "high",
        "kalshi": "silent",
        "polymarket": "50_50_prestart",
        "note": "Polymarket settles a pre-start forfeit 50-50; Kalshi's policy isn't stated. A held two-leg position may not return $1 on a forfeit."
      }
    ],
    "kalshi_text": "If the listed game is not completed, this market resolves according to the official league make-up game. If no make-up game is played this season, the market resolves NO.",
    "poly_text": "This market resolves according to the official result of the game named in the title. If the game is postponed, this market stays open until the game is completed.",
    "verdict": null
  }
}

字段说明

字段类型含义
id / slug / titlestring身份字段，与该市场对的标准 Market 对象保持一致。
statusstring取值为 open、resolving、closed 或settled 之一，详见市场状态。
settlement.parityboolean截至本次查询，该市场对完整内部风险集合是否为空。
settlement.risks[]array已披露的分歧点，每一项包含 event、取值为 high 或bounded 的 severity，以及说明用的 note。取消类事件会在服务端过滤，不出现在这个数组中，完整的判定逻辑见Signal。
settlement.kalshi_text / settlement.poly_textstring|null两个平台各自为该市场公开的结算规则原文，并排呈现。
settlement.verdictstring|null在 status 变为 settled 之前为 null，之后取值为agree、diverge 或 edge_case。

这个接口永远不会返回什么

合约由各自平台自行结算。dino.markets 不是 Kalshi 或 Polymarket 任何一份合约的结算方，这个接口也永远不会携带某个平台单方面判定的获胜结果字段，更不会把某个平台的结果改写成我们自己的结论。它公开的是两个平台各自发布的结算规则原文，并在双方都结算完成后，给出一个双方是否一致、出现分歧、还是属于边缘情况的判定。任何一份具体合约的最终结算，请以对应平台自身的链接为准。完整立场见免责声明。

通过 MCP 客户端调用

get_settlement 工具与这个接口一一对应：返回身份信息加结算字段，不含价格数据，id/slug/UUID 的解析方式与 get_market 相同。任何有效密钥都可以调用，包括 Free 档位。连接方式见MCP 服务器。