FTLib

数据服务

L2 逐笔行情

十档盘口、逐笔成交、逐笔委托与委托队列,支持实时推送与历史回溯。适用于订单流分析、微观结构研究、冲击成本估计与高频因子构建。

实时推送十档盘口逐笔成交逐笔委托历史回溯

L2 行情描述的是订单簿如何变化。除了十档盘口,它还包含逐笔成交、逐笔委托与撤单信息,可用于还原主动买卖方向、估计订单流不平衡、观察大单行为与评估交易成本。

FTLib 的 L2 推送与历史查询使用同一套序列号。实时订阅按序列号连续接收;历史查询按交易日与 start_seq 分页读取。两者可以拼接,用于回测复现、异常排查与实盘补数。

覆盖范围

逐笔字段在不同交易所之间存在结构差异,FTLib 在统一字段层做了映射,同时保留原始序列号与成交编号,便于追溯。

项目说明
品种沪深股票、可转债等(以授权范围为准)
市场上交所、深交所、北交所
交易时段集合竞价、连续竞价、收盘集合竞价
推送粒度盘口快照、逐笔成交、逐笔委托
历史查询按证券与交易日查询,序列号分页
盘口档位买卖各十档
时间戳毫秒级,时区 Asia/Shanghai
复权逐笔与盘口均为原始价格,不复权

字段说明

逐笔成交与逐笔委托使用独立通道。成交记录不直接包含委托方向,需要结合委托流或交易所方向字段处理。

字段类型说明
symbolstring证券代码,如 600519.SH
tsint64毫秒时间戳
seqint64行情序列号,用于续传与去重
bids / asksarray十档盘口,元素含 price、volume
pricenumber逐笔成交价
volumeint64逐笔成交量,股票为股,可转债为张
sidestring主动方向,B 或 S
trade_idstring成交编号
order_idstring委托编号
order_typestring委托类型,如限价、市价、本方最优
cancel_flagbool是否为撤单
phasestring交易阶段,如集合竞价、连续竞价

请求示例

历史逐笔按交易日查询,使用 start_seq 与 limit 分页;推送订阅使用 quote.l2.trade 通道。

查询历史逐笔成交

返回按序列号升序排列的成交记录,建议持久化最后处理的 seq。

bash
curl -H "Authorization: Bearer $FTLIB_API_KEY" \
  "https://api.ftlib.com/v1/l2/trades?symbol=600519.SH&date=2026-11-13&start_seq=0&limit=1000"

逐笔成交返回结构

截取两条记录用于说明字段。

json
{
  "code": 0,
  "message": "ok",
  "request_id": "req_2b91e640",
  "data": {
    "symbol": "600519.SH",
    "date": "2026-11-13",
    "next_seq": 1000,
    "has_more": true,
    "items": [
      {
        "seq": 4818291,
        "ts": 1794553200123,
        "price": 1688.00,
        "volume": 300,
        "side": "B",
        "trade_id": "T20261113000123",
        "phase": "continuous"
      },
      {
        "seq": 4818292,
        "ts": 1794553200188,
        "price": 1688.00,
        "volume": 100,
        "side": "S",
        "trade_id": "T20261113000124",
        "phase": "continuous"
      }
    ]
  }
}

订阅逐笔成交

连接建立后先发送 auth 消息,再发送 subscribe;seq 为期望续传位置,0 表示从最新开始。

json
{
  "op": "subscribe",
  "channel": "quote.l2.trade",
  "symbols": ["600519.SH"],
  "seq": 4818292
}

数据口径与更新

  • 逐笔数据来源于交易所行情文件,保留原始序列号、成交编号与委托编号,便于与原始文件核对。
  • 集合竞价与连续竞价使用 phase 区分,统计主动买卖、成交分布或订单流指标前应先过滤交易阶段。
  • 历史查询按 seq 升序返回;当 has_more 为 true 时,使用返回的 next_seq 继续请求。
  • 逐笔价格与数量保持交易所原始单位,不复权。可转债成交量单位为张,股票为股。
  • 同一毫秒内可能有多条记录,排序应以交易所序列号为准,不应仅依赖时间戳。
L2 十档盘口结构示意,包含买卖档位、价格、数量与序列号
十档盘口与逐笔明细的结构示意。图中数值为示例数据。
使用建议 如果研究目标涉及订单流、盘口失衡或执行成本,应使用逐笔数据;仅使用十档快照会丢失档位之间的委托变化。

典型用法

常见问题

L2 与 L1 的主要区别是什么?
L1 提供五档快照;L2 提供十档盘口、逐笔成交、逐笔委托与委托队列。L2 的数据量与计算复杂度更高,适合微观结构研究。
逐笔成交的 side 如何定义?
side 表示主动方向,B 为主动买,S 为主动卖。不同交易所的原始字段不同,FTLib 在统一字段层完成映射,并保留原始记录用于核对。
历史逐笔如何分页与续传?
使用 start_seq 与 limit 分页,响应中的 next_seq 作为下一页起点。推送断线后可用最后处理的 seq 重新订阅或查询。
是否提供复权后的逐笔价格?
不提供。逐笔与盘口保持交易所原始价格,复权仅在 K 线等价格序列数据中提供。

用逐笔数据还原订单簿

查看推送协议、历史逐笔分页方式与字段字典,或提交接入咨询确认 L2 授权范围与历史深度。