GET获取市场订单簿

检索特定结果的当前订单簿（买单和卖单）。可交叉订单通过匹配模拟移除。订单簿是统一的——它合并了 YES 和 NO 两侧的流动性。

请求

GET /v1/markets/:id/orderbook

路径参数

参数	类型	必填	描述
`id`	string	是	Market UUID

查询参数

参数	类型	必填	描述
`outcomeId`	string	是	获取订单簿的结果 ID

响应

{
  "outcomeId": "outcome-uuid-1",
  "outcomeSide": "Yes - YES",
  "bids": [
    { "price": "0.650", "shares": "500.00" },
    { "price": "0.640", "shares": "300.00" },
    { "price": "0.620", "shares": "150.00" }
  ],
  "asks": [
    { "price": "0.680", "shares": "200.00" },
    { "price": "0.700", "shares": "400.00" },
    { "price": "0.750", "shares": "100.00" }
  ]
}

响应字段

字段	类型	描述
`outcomeId`	string	此订单簿代表的结果 ID
`outcomeSide`	string	结果名称和方向的组合（例如 `Yes - YES`、`Trump - YES`）
`bids`	array	买单，按价格降序排列
`asks`	array	卖单，按价格升序排列
`bids[].price`	string	买入价格（3位小数）
`bids[].shares`	string	此价格水平的总份额

统一订单簿

订单簿合并了两侧的流动性：

YES 买单 = 买入 YES 订单 + 卖出 NO 订单（反转价格）
YES 卖单 = 卖出 YES 订单 + 买入 NO 订单（反转价格）

可交叉订单（买入价 >= 卖出价）通过匹配模拟移除，提供反映待处理匹配完成后预期状态的清洁订单簿。

错误

状态码	描述
`400`	缺少 `outcomeId` 或结果不属于此市场
`404`	未找到市场或结果

基于 Slug 的替代方案

如果您使用 WebSocket 信号（提供基于 slug 的频道名称 market:{slug}:orderbook），可以使用基于 slug 的端点，无需维护 slug-to-UUID 映射：

GET /v1/markets/slug/:slug/orderbook

详情请参见通过 Slug 获取订单簿。

示例

curl "https://api.conviction.bet/v1/markets/550e8400-e29b-41d4-a716-446655440000/orderbook?outcomeId=outcome-uuid-1"