ACCESS
接入与配额
FTLib 按数据域与使用场景授权。提交接入咨询后,我们会确认品种范围、历史深度、推送规格与配额,再提供密钥与字段字典。
REST + WebSocket按数据域授权测试额度字段字典
接入流程
1
提交需求
说明研究用途、数据域、品种范围、调用量与历史深度。
2
确认范围
核对授权、配额、字段可用性与合规要求,确认接入方案。
3
验证链路
使用测试额度验证 REST 查询、推送订阅与错误处理。
4
上线与监控
切换生产密钥,监控延迟、配额、序列号缺口与重连次数。
配额维度
配额按数据域与接入方式分别计算。以下为常见维度,具体额度以接入方案为准。
| 维度 | 说明 | 适用 |
|---|---|---|
| REST QPS | 每秒请求数上限,超限返回 429 | 所有 REST 接口 |
| 日调用量 | 自然日累计请求数 | REST 查询 |
| 并发连接 | 同时建立的 WebSocket 连接数 | 实时推送 |
| 订阅代码数 | 单连接或单密钥可订阅的证券数量 | L1 / L2 推送 |
| 历史深度 | 可查询的最早交易日 | 逐笔、K 线、财务 |
| 数据域 | 行情、基本面、基金与可转债分别授权 | 全部接口 |
申请信息模板
发送邮件至 support@ftlib.com,建议包含以下信息。请勿在邮件中发送完整密钥或敏感凭证。
项目 / 机构名称:
研究用途:
所需数据域:L1 / L2 / K 线 / 财务 / 龙虎榜 / 股东 / 行业 / IPO / ETF / 可转债
品种范围:
预计日调用量:
预计并发连接数:
是否需要历史逐笔及历史深度:
期望开始时间:
技术准备
- 支持 TLS 1.2 及以上的 HTTPS 与 WSS 客户端。
- 推送客户端需实现鉴权、心跳、序列号持久化与指数退避重连。
- 服务器时间应与 NTP 同步,避免时间戳校验与日志排查困难。
- 历史逐笔数据量较大,建议规划本地存储、分区与去重策略。
合规使用
数据仅限授权范围内的研究与系统接入,不得转售、再分发或用于违反交易所规则与适用法律的用途。
常见问题
接入需要提供哪些信息?
请说明机构或项目名称、研究用途、所需数据域与品种、预计日调用量与并发连接数、是否需要历史逐笔,以及希望的开始时间。信息越完整,确认授权范围越快。
是否提供测试密钥?
根据接入方案提供测试额度,用于验证鉴权、字段与推送链路。测试密钥与生产密钥分离,测试流量不计入生产配额。
配额如何计算?
REST 按 QPS 与日调用量统计,推送按并发连接数与订阅代码数统计。L2 历史逐笔可能按查询量或数据量单独计量,具体以接入方案为准。
从申请到可用需要多久?
取决于数据域、授权范围与合规审核。收到完整信息后,我们会先确认可行性与所需材料,再给出开通安排。