盘口深度

GET/api/v1/markets/{marketId}/book公开

Trading API价 E4 · 量 E2 · 金额 E6（整数）YES | NO

YES 计价的买卖档位（priceE4/sizeE2）。depth 默认 10，服务端钳到 100。支持 minCursor。

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"

查询参数

depthintegerquery可选
返回的档位数量
默认10范围≥ 1示例10
minCursorstringquery可选
读己之写续读点（下单 202 响应体的 cursor 原样传入）。投影未追上时该查询返回 404，与"资源不存在"不可区分——带同一个 cursor 轮询。
示例"c1:mkt-0001:184"

响应

200盘口快照

marketstring
市场 id
示例"mkt-0001"
yesBidsobject(DepthLevel)[]
YES 侧买档，价格从优到劣
priceE4integer
价格档位（1e-4 USD）
示例5200
sizeE2int64
该档位挂单量（1e-2 份）
示例1000
yesAsksobject(DepthLevel)[]
YES 侧卖档
priceE4integer
价格档位（1e-4 USD）
示例5200
sizeE2int64
该档位挂单量（1e-2 份）
示例1000

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X GET "$BASE_URL/api/v1/markets/mkt-0001/book?depth=10"

响应

盘口快照

{
  "market": "mkt-0001",
  "yesBids": [
    {
      "priceE4": 5200,
      "sizeE2": 1000
    }
  ],
  "yesAsks": [
    {
      "priceE4": 5200,
      "sizeE2": 1000
    }
  ]
}

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"

查询参数

depthintegerquery可选
返回的档位数量
默认10范围≥ 1示例10
minCursorstringquery可选
读己之写续读点（下单 202 响应体的 cursor 原样传入）。投影未追上时该查询返回 404，与"资源不存在"不可区分——带同一个 cursor 轮询。
示例"c1:mkt-0001:184"

响应

200盘口快照

marketstring
市场 id
示例"mkt-0001"
yesBidsobject(DepthLevel)[]
YES 侧买档，价格从优到劣
priceE4integer
价格档位（1e-4 USD）
示例5200
sizeE2int64
该档位挂单量（1e-2 份）
示例1000
yesAsksobject(DepthLevel)[]
YES 侧卖档
priceE4integer
价格档位（1e-4 USD）
示例5200
sizeE2int64
该档位挂单量（1e-2 份）
示例1000

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。