数据服务
L2 逐笔行情
十档盘口、逐笔成交、逐笔委托与委托队列,支持实时推送与历史回溯。适用于订单流分析、微观结构研究、冲击成本估计与高频因子构建。
实时推送十档盘口逐笔成交逐笔委托历史回溯
L2 行情描述的是订单簿如何变化。除了十档盘口,它还包含逐笔成交、逐笔委托与撤单信息,可用于还原主动买卖方向、估计订单流不平衡、观察大单行为与评估交易成本。
FTLib 的 L2 推送与历史查询使用同一套序列号。实时订阅按序列号连续接收;历史查询按交易日与 start_seq 分页读取。两者可以拼接,用于回测复现、异常排查与实盘补数。
覆盖范围
逐笔字段在不同交易所之间存在结构差异,FTLib 在统一字段层做了映射,同时保留原始序列号与成交编号,便于追溯。
| 项目 | 说明 |
|---|---|
| 品种 | 沪深股票、可转债等(以授权范围为准) |
| 市场 | 上交所、深交所、北交所 |
| 交易时段 | 集合竞价、连续竞价、收盘集合竞价 |
| 推送粒度 | 盘口快照、逐笔成交、逐笔委托 |
| 历史查询 | 按证券与交易日查询,序列号分页 |
| 盘口档位 | 买卖各十档 |
| 时间戳 | 毫秒级,时区 Asia/Shanghai |
| 复权 | 逐笔与盘口均为原始价格,不复权 |
字段说明
逐笔成交与逐笔委托使用独立通道。成交记录不直接包含委托方向,需要结合委托流或交易所方向字段处理。
| 字段 | 类型 | 说明 |
|---|---|---|
symbol | string | 证券代码,如 600519.SH |
ts | int64 | 毫秒时间戳 |
seq | int64 | 行情序列号,用于续传与去重 |
bids / asks | array | 十档盘口,元素含 price、volume |
price | number | 逐笔成交价 |
volume | int64 | 逐笔成交量,股票为股,可转债为张 |
side | string | 主动方向,B 或 S |
trade_id | string | 成交编号 |
order_id | string | 委托编号 |
order_type | string | 委托类型,如限价、市价、本方最优 |
cancel_flag | bool | 是否为撤单 |
phase | string | 交易阶段,如集合竞价、连续竞价 |
请求示例
历史逐笔按交易日查询,使用 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 与 L1 的主要区别是什么?
L1 提供五档快照;L2 提供十档盘口、逐笔成交、逐笔委托与委托队列。L2 的数据量与计算复杂度更高,适合微观结构研究。
逐笔成交的 side 如何定义?
side 表示主动方向,B 为主动买,S 为主动卖。不同交易所的原始字段不同,FTLib 在统一字段层完成映射,并保留原始记录用于核对。
历史逐笔如何分页与续传?
使用 start_seq 与 limit 分页,响应中的 next_seq 作为下一页起点。推送断线后可用最后处理的 seq 重新订阅或查询。
是否提供复权后的逐笔价格?
不提供。逐笔与盘口保持交易所原始价格,复权仅在 K 线等价格序列数据中提供。