数据服务
L1 实时行情
提供股票、指数、ETF/LOF 与可转债的实时快照行情:最新价、涨跌幅、成交量额与五档买卖盘,支持批量订阅与按代码查询。
实时推送五档盘口批量订阅REST 快照
L1 行情是量化系统中最基础的一层数据。它提供证券在某一时刻的最新价、开高低收、成交量额与五档买卖盘,足以支撑组合监控、风控阈值、分钟级信号与大部分中低频策略。
FTLib 将 L1 快照推送与 REST 查询放在同一套证券代码与字段体系下。推送端适合持续订阅,查询端适合初始化、补数与批量校验;两端使用相同的 symbol、ts 与盘口字段,减少研究环境与生产环境的切换成本。
覆盖范围
覆盖范围以实际授权为准。指数与 ETF 的部分字段可用性随交易所披露口径略有差异,接入前可在字段字典中逐项核对。
| 项目 | 说明 |
|---|---|
| 品种 | 沪深股票、指数、ETF/LOF、可转债 |
| 市场 | 上交所、深交所、北交所 |
| 快照内容 | 最新价、开高低收、昨收、成交量、成交额、五档盘口 |
| 盘口档位 | 买卖各五档 |
| 推送方式 | WebSocket 订阅,支持批量代码与断线重连 |
| 查询方式 | REST 快照,支持多代码批量查询 |
| 时间戳 | 毫秒级 epoch,时区 Asia/Shanghai |
| 复权 | 行情快照为原始价格,不提供复权 |
字段说明
字段命名在 REST 与推送中保持一致。盘口数组按价格优先、时间优先排序,空档位不会补零。
| 字段 | 类型 | 说明 |
|---|---|---|
symbol | string | 证券代码,如 600519.SH |
name | string | 证券简称 |
ts | int64 | 快照时间,毫秒级 epoch |
last | number | 最新成交价 |
open / high / low | number | 当日开盘价、最高价、最低价 |
prev_close | number | 昨收价,用于计算涨跌幅 |
volume | int64 | 当日成交量,股票为股,可转债为张 |
amount | number | 当日成交额,单位为元 |
limit_up / limit_down | number | 涨跌停价,指数无此字段 |
bids | array | 买五档,元素含 price 与 volume |
asks | array | 卖五档,元素含 price 与 volume |
status | string | 交易状态,如集合竞价、连续竞价、停牌 |
请求示例
以下请求返回两只证券的最新快照。示例数值仅用于说明字段含义,不代表实时行情。
批量快照查询
使用 Bearer Token 鉴权,多个代码用英文逗号分隔。
bash
curl -H "Authorization: Bearer $FTLIB_API_KEY" \
"https://api.ftlib.com/v1/quote/snapshot?symbols=600519.SH,000001.SZ"
返回结构
成功响应的 code 为 0,data 为数组,顺序与请求代码一致。
json
{
"code": 0,
"message": "ok",
"request_id": "req_7f3c9a21",
"data": [
{
"symbol": "600519.SH",
"name": "贵州茅台",
"ts": 1794794400000,
"last": 1688.00,
"open": 1675.00,
"high": 1695.50,
"low": 1670.10,
"prev_close": 1672.30,
"volume": 2154300,
"amount": 3635123400.00,
"limit_up": 1839.53,
"limit_down": 1505.07,
"status": "continuous",
"bids": [
{ "price": 1687.90, "volume": 300 },
{ "price": 1687.80, "volume": 500 },
{ "price": 1687.70, "volume": 200 },
{ "price": 1687.60, "volume": 800 },
{ "price": 1687.50, "volume": 100 }
],
"asks": [
{ "price": 1688.00, "volume": 200 },
{ "price": 1688.10, "volume": 400 },
{ "price": 1688.20, "volume": 600 },
{ "price": 1688.30, "volume": 300 },
{ "price": 1688.40, "volume": 500 }
]
}
]
}
数据口径与更新
- 快照按交易所披露频率更新。推送端可能合并同一时刻的重复快照,客户端应以
ts与序列号去重。 - 集合竞价阶段盘口可能为空或不完整,建议结合
status字段与交易时段判断,不将集合竞价快照混入连续竞价统计。 - 停牌期间快照可能保持停牌前值,成交量不再增长。使用前应检查交易状态,避免把静态快照当作活跃行情。
- 价格单位为元,成交量单位为股(可转债为张),成交额单位为元。指数不提供涨跌停价。
- 涨跌停价按所属板块与交易规则计算,主板、科创板、创业板与 ST 证券的幅度不同。
示例数据说明
页面中的价格、成交量与时间戳均为字段解释用示例数据,不可用于交易决策或收益计算。
典型用法
常见问题
L1 与 L2 的盘口档位有什么差异?
L1 提供买卖各五档快照;L2 在十档盘口之外,还提供逐笔成交、逐笔委托与委托队列。两者不是简单的新旧关系,应按研究需求选择。
是否提供历史快照数据?
历史分钟级数据可通过 K 线与历史分时接口获取;全量历史快照与逐笔明细请参考 L2 数据服务及接入方案中的授权范围。
推送断线后如何补齐数据?
客户端应记录最后处理的序列号,重连后携带该序列号续传;若缺口超出服务端保留范围,可用 REST 快照重新对齐。
指数行情包含哪些字段?
指数提供最新点位、开高低、成交量与成交额等字段,不提供涨跌停价与逐笔委托。具体字段以接口返回为准。