FTLib

数据服务

K 线与历史分时

提供 1/5/15/30/60 分钟、日/周/月 K 线与复权因子,以及按日历史分时数据,覆盖股票、指数、ETF/LOF 与可转债。

多周期前复权 / 后复权复权因子历史分时

K 线把成交数据压缩成可计算的序列,是因子研究、回测与可视化最常用的数据形态。历史分时则保留了日内更细的采样点,适合研究开盘冲击、VWAP、日内动量与成交量分布。

FTLib 提供不同周期的 K 线、复权因子与按日历史分时。分钟线采用固定的时间对齐规则,日线在收盘后完成校验入库;复权因子单独提供,便于研究者按自己的口径重新计算价格序列。

覆盖范围

不同周期的字段一致,时间戳表示 bar 的起始时间。历史深度以接入方案为准;指数与基金的成交量单位与股票不同。

项目说明
周期1/5/15/30/60 分钟、日、周、月
复权不复权、前复权、后复权,另提供复权因子
历史分时按交易日查询,返回日内采样序列
覆盖品种股票、指数、ETF/LOF、可转债
时间标签bar 起始时间,左闭右开
更新时间分钟线盘中更新,日线收盘后校验入库
时区Asia/Shanghai
价格单位元;指数为点位

字段说明

价格字段始终为原始价格;使用 adjust=forward 或 adjust=backward 时,服务端按复权因子计算,并在响应中返回所用因子。

字段类型说明
symbolstring证券代码
periodstring1m、5m、1d 等
tsint64bar 起始时间,毫秒级 epoch
open / high / low / closenumber开盘、最高、最低、收盘价
volumeint64成交量
amountnumber成交额
trade_countint64成交笔数(如披露)
adjuststring复权方式
factornumber复权因子
pre_closenumber前收盘价(不复权)

请求示例

以下请求获取 2026 年以来的前复权日线。历史分时使用 /v1/intraday,按交易日查询。

日线查询

adjust 可取 none、forward、backward,默认 none。

bash
curl -H "Authorization: Bearer $FTLIB_API_KEY" \
  "https://api.ftlib.com/v1/kline?symbol=600519.SH&period=1d&start=2026-01-01&end=2026-11-13&adjust=forward"

返回结构

bars 数组按时间升序排列。

json
{
  "code": 0,
  "message": "ok",
  "request_id": "req_5d0c8f11",
  "data": {
    "symbol": "600519.SH",
    "period": "1d",
    "adjust": "forward",
    "bars": [
      {
        "ts": 1767628800000,
        "open": 1660.00,
        "high": 1678.50,
        "low": 1652.10,
        "close": 1672.30,
        "volume": 1984500,
        "amount": 3321456000.00,
        "trade_count": 182300,
        "factor": 1.0000,
        "pre_close": 1655.20
      }
    ]
  }
}

历史分时查询

返回指定交易日内的分时采样点,适合计算 VWAP 与日内特征。

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

数据口径与更新

  • 分钟线采用左闭右开区间,例如 09:31 标签表示 09:30:00 至 09:30:59 的成交聚合。跨日回测应显式处理首尾 bar。
  • 集合竞价成交量通常归入当日第一根分钟线或独立字段,使用前应确认口径,避免重复计算开盘成交。
  • 前复权保持最新价格不变、调整历史价格;后复权保持历史价格不变、调整最新价格。回测中混用两种方式会导致收益曲线不可比。
  • 停牌日通常不生成 bar,或以零成交记录表示。应结合交易日历补齐日期索引,避免时间序列错位。
  • 历史分时的采样频率与交易所快照频率相关,缺失点不自动插值;研究时应根据策略需要选择前值填充或空值处理。
复权因子单独保存 建议同时保存不复权价格与复权因子,在需要时再计算复权序列。这样可以在因子口径变化时快速重算,而不必重新拉取全部行情。

典型用法

常见问题

回测应该使用前复权还是后复权?
如果以当前价格为基准计算收益,通常使用前复权;如果研究历史时点的价格水平或需要固定历史价格,可使用后复权。关键是全流程保持一致,并保存复权因子。
分钟线的时间标签代表开始还是结束?
FTLib 的分钟线标签表示 bar 的起始时间,区间左闭右开。接入前应在文档中确认该口径,避免与其他数据源拼接时错位。
停牌日会返回 K 线吗?
通常不生成成交 bar。建议使用交易日历构建完整日期索引,并按研究需要选择空值或前值填充。
历史分时是否复权?
历史分时保持当日原始价格,不提供跨日复权。跨日收益计算应结合 K 线与复权因子。

用统一口径的价格序列做研究

查看 K 线与历史分时的参数、复权规则与时间对齐说明,或提交接入咨询确认历史深度。