FTLib

数据服务

L1 实时行情

提供股票、指数、ETF/LOF 与可转债的实时快照行情:最新价、涨跌幅、成交量额与五档买卖盘,支持批量订阅与按代码查询。

实时推送五档盘口批量订阅REST 快照

L1 行情是量化系统中最基础的一层数据。它提供证券在某一时刻的最新价、开高低收、成交量额与五档买卖盘,足以支撑组合监控、风控阈值、分钟级信号与大部分中低频策略。

FTLib 将 L1 快照推送与 REST 查询放在同一套证券代码与字段体系下。推送端适合持续订阅,查询端适合初始化、补数与批量校验;两端使用相同的 symbol、ts 与盘口字段,减少研究环境与生产环境的切换成本。

覆盖范围

覆盖范围以实际授权为准。指数与 ETF 的部分字段可用性随交易所披露口径略有差异,接入前可在字段字典中逐项核对。

项目说明
品种沪深股票、指数、ETF/LOF、可转债
市场上交所、深交所、北交所
快照内容最新价、开高低收、昨收、成交量、成交额、五档盘口
盘口档位买卖各五档
推送方式WebSocket 订阅,支持批量代码与断线重连
查询方式REST 快照,支持多代码批量查询
时间戳毫秒级 epoch,时区 Asia/Shanghai
复权行情快照为原始价格,不提供复权

字段说明

字段命名在 REST 与推送中保持一致。盘口数组按价格优先、时间优先排序,空档位不会补零。

字段类型说明
symbolstring证券代码,如 600519.SH
namestring证券简称
tsint64快照时间,毫秒级 epoch
lastnumber最新成交价
open / high / lownumber当日开盘价、最高价、最低价
prev_closenumber昨收价,用于计算涨跌幅
volumeint64当日成交量,股票为股,可转债为张
amountnumber当日成交额,单位为元
limit_up / limit_downnumber涨跌停价,指数无此字段
bidsarray买五档,元素含 price 与 volume
asksarray卖五档,元素含 price 与 volume
statusstring交易状态,如集合竞价、连续竞价、停牌

请求示例

以下请求返回两只证券的最新快照。示例数值仅用于说明字段含义,不代表实时行情。

批量快照查询

使用 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 快照重新对齐。
指数行情包含哪些字段?
指数提供最新点位、开高低、成交量与成交额等字段,不提供涨跌停价与逐笔委托。具体字段以接口返回为准。

把 L1 快照接入你的研究流程

查看 REST 请求规范与推送订阅方式,或提交接入咨询以确认品种授权、配额与连接规格。