盘口快照

接口路径

GET /api/market/orderbook

批量拉取指定产品当前的买卖盘深度快照。

请求参数（Query）

参数	类型	必填	默认值	说明
syms	string	是	-	产品代码列表，逗号分割，如 AAPL.US,TSLA.US
level	int32	否	1	请求盘口档数：1~`5` 档。不传或传 0 默认返回最优 1 档。实际返回档数受套餐与市场挂单情况限制

响应字段说明

• ask：卖盘矩阵，按价格升序排列（卖一 < 卖二 < 卖三）。无挂单时返回 []。
• bid：买盘矩阵，按价格降序排列（买一 > 买二 > 买三）。无挂单时返回 []。

买卖盘每档数据索引 [0]~`[2]`：

索引	字段	类型	说明
[0]	price	string	挂单价格
[1]	volume	float64	挂单量
[2]	order_num	int32	订单挂单笔数（仅股票支持；外汇、期货、加密货币等无笔数品种固定返回 -1）

响应示例

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "sym": "AAPL.US",
      "ask": [
        ["180.51", 500.0, 2],
        ["180.52", 800.0, 3]
      ],
      "bid": [
        ["180.50", 1000.0, 5],
        ["180.49", 2500.0, 12]
      ]
    },
    {
      "sym": "EURUSD",
      "ask": [
        ["1.0853", 140000.0, -1],
        ["1.0854", 220000.0, -1]
      ],
      "bid": [
        ["1.0852", 100000.0, -1],
        ["1.0851", 300000.0, -1]
      ]
    }
  ]
}

说明

• ask / bid 中 price 均为字符串，与逐笔接口保持一致。
• 非股票品种 order_num 恒为 -1，前端不应据此绘制挂单笔数。
• 实时盘口变动建议改用 WebSocket event=3 推送，详见 实时推送。