数据服务
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 时,服务端按复权因子计算,并在响应中返回所用因子。
| 字段 | 类型 | 说明 |
|---|---|---|
symbol | string | 证券代码 |
period | string | 1m、5m、1d 等 |
ts | int64 | bar 起始时间,毫秒级 epoch |
open / high / low / close | number | 开盘、最高、最低、收盘价 |
volume | int64 | 成交量 |
amount | number | 成交额 |
trade_count | int64 | 成交笔数(如披露) |
adjust | string | 复权方式 |
factor | number | 复权因子 |
pre_close | number | 前收盘价(不复权) |
请求示例
以下请求获取 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 线与复权因子。