对于构建金融看板或量化交易机器人的开发者和交易者而言，可靠的历史 K 线 (Kline) 数据是技术分析的基石。无论您是在进行策略回测还是可视化市场趋势，Alltick API 都提供了一个高效的 REST 接口，支持跨资产类别的历史数据获取。
本指南将详细介绍如何调用 Alltick K 线接口、参数要求，以及不同订阅计划对数据深度的影响。
详解 Alltick K 线接口
获取历史 K 线数据的核心端点（Endpoint）为：
该接口采用 GET 方法。与传统的简单键值对 URL 不同，Alltick 要求将参数封装在一个 JSON 查询字符串中进行传递。
请求结构与参数说明
要成功调用 API，您需要提供身份验证 token 和一个 query 对象。以下是核心参数的详细说明：
| 参数名称 | 类型 | 描述 |
| token | String | 您的唯一 API 访问密钥（鉴权令牌）。 |
| code | String | 资产代码（例如：加密货币 BTCUSDT，股票 AAPL）。 |
| kline_type | Integer | K 线周期类型（例如：8 通常代表“日线”级别）。 |
| kline_timestamp_end | Integer | 查询范围的截止 Unix 时间戳。 |
| query_kline_num | Integer | 单次请求获取的 K 线根数。 |
| adjust_type | Integer | 价格复权类型（例如：用于处理股票拆分或分红）。 |
专业提示： 请确保
kline_timestamp_end使用正确的 Unix 时间戳格式（秒），以避免返回空数据或同步错误。
订阅方案与数据权限
您能够追溯的历史数据时长（回溯深度）取决于您的 Alltick 订阅层级。在构建数据流水线之前，请根据以下标准核实您的需求：
1. 通用多资产计划
这些方案非常适合常规市场分析和加密货币项目。
- 免费版 (Free) 与 基础版 (Basic)： 支持获取最多 1 年 的历史数据。
- 高级版 (Premium)： 支持获取最多 3 年 的历史数据。
- 专业版 (Professional)： 支持获取最多 5 年 的历史数据。
2. 区域股票计划 (港股/A股/美股)
如果您订阅的是特定的区域股票数据包，历史深度通常限制为最近的 500 根 K 线。这对于短线波段交易和日内分析来说已经足够。
为什么选择 Alltick 获取历史数据？
使用 quote-b-api/kline 接口为金融科技开发者带来诸多优势：
- 数据一致性： 获得与机构级平台同等高质量的数据源。
- 高扩展性： 随着回测需求的增长，支持从 1 年深度无缝升级至 5 年。
- 多资产覆盖： 统一的接口结构即可处理外汇、加密货币及全球股票数据。
准备好开始编程了吗？ 立即登录您的 Alltick 控制台获取 API Token，将实时与历史市场数据集成到您的应用中。
