FAQ
常见问题
关于数据范围、接入鉴权、推送续传、数据口径与合规使用的常见问题。若未找到答案,可通过支持邮箱联系。
16 个问题接入推送数据口径
数据范围
FTLib 覆盖哪些证券品种?
覆盖沪深京 A 股股票、指数、ETF/LOF 与可转债。行情包括 L1、L2、K 线与历史分时;基本面包括财务、龙虎榜、股东、行业板块与 IPO;基金与衍生品包括 ETF/LOF 持仓和可转债信息。
是否提供指数和 ETF 的 L2 数据?
L2 逐笔与十档盘口主要覆盖股票与可转债等品种,指数通常不提供逐笔委托。ETF 的可用字段取决于交易所披露与授权范围,接入前请核对字段字典。
历史数据可以追溯多久?
不同数据域的历史深度不同。K 线与财务通常覆盖较长历史,逐笔数据的历史深度与授权方案相关。请在接入咨询时说明所需最早日期。
接入与鉴权
如何获取 API Key?
通过接入页面提交咨询,说明研究用途、数据域、品种范围与调用量。确认授权与配额后,我们会提供密钥与字段字典。
REST 与推送使用同一个密钥吗?
使用同一把 API Key,但鉴权方式不同。REST 在 Authorization 头中携带 Bearer Token;WebSocket 连接建立后发送 auth 消息。
密钥可以放在浏览器前端吗?
不可以。密钥应仅保存在服务端,通过环境变量或密钥管理服务注入,避免暴露给终端用户。
如何轮换密钥?
先创建新密钥并更新服务配置,验证 REST、历史查询与推送订阅均正常,再停用旧密钥。建议保留短暂的双密钥并行窗口。
推送与限流
推送断线后如何补齐数据?
客户端应持久化最后处理的序列号,重连后携带该序列号续传。若缺口超出服务端保留窗口,使用 REST 快照或历史查询重新对齐。
默认限流是多少?
REST 默认限流为 20 QPS,具体以接入方案为准。超限返回 HTTP 429。推送连接数与订阅代码数另有约束。
遇到 429 应该怎么处理?
降低并发,使用指数退避与随机抖动重试。不要立即高频重试,以免延长限流时间。
数据口径
K 线支持复权吗?
支持不复权、前复权与后复权,并返回本次使用的复权因子。建议同时保存不复权价格与因子,便于重算。
财务数据按报告期还是公告日?
接口同时返回报告期与公告日。回测应按公告日或 as_of 参数限制可见时间,避免使用尚未披露的数据。
成交量单位是什么?
股票为股,可转债为张,基金为份。成交额统一为元,价格统一为元(指数为点位)。
时间戳使用什么时区?
毫秒级 epoch,展示时使用 Asia/Shanghai。跨时区系统应在展示层转换,不要在数据层混用本地时间。
合规与使用
数据可以转售或再分发吗?
不可以。数据仅限授权范围内的研究与系统接入,不得转售、再分发或用于违反交易所规则与适用法律的用途。
站内内容构成投资建议吗?
不构成。站内文档、文章与示例数据仅用于技术说明与数据口径解释,不构成任何投资建议或收益承诺。