跳转至

L2 十档盘口

来源同步:/Users/mac/Projects/chatgpt-codex/doc/api_Quotes.md

所属接口集:股票行情

请求 URL

GET /v1/api/l2/orderbook10

认证方式

Bearer Token(详见 认证与签名

接口概述

从本地捕获的 TDX frames 二进制文件中提取指定股票的十档买卖盘口数据。

请求参数

Query 参数:

参数 类型 必填 默认值 说明
code string - 股票代码,如 600089600089.SH
frames string frames.bin frames 文件路径。优先使用按股票代码分割的文件

接口说明

  • 需要预先通过 stream_watch --split-by-code 等方式生成 frames 二进制文件。
  • 解析失败返回 HTTP 500,找不到对应股票数据返回 HTTP 404

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "buy": [
      {"price": 10.24, "volume": 500},
      {"price": 10.23, "volume": 320},
      {"price": 10.22, "volume": 100}
    ],
    "sell": [
      {"price": 10.26, "volume": 200},
      {"price": 10.27, "volume": 150},
      {"price": 10.28, "volume": 80}
    ],
    "ts": 1723968000
  }
}

返回状态

状态码 说明
200 成功
400 缺少 code 参数
401 未认证
403 无权限
404 未找到指定股票的盘口数据
500 frames 文件解析失败