历史K线查询

接口能力

本接口提供全球多种金融品种（包括股票、外汇、期货、贵金属、加密货币、股指等）的历史 K 线行情数据查询。支持从 1 分钟到月线的多种时间周期（如 1M, 5M, 15M, 30M, 1H, 4H, D, W, M）。接口根据指定的日期和周期，返回包含时间戳、开盘价、最高价、最低价、收盘价及成交量等核心指标的 K 线数据。

请求与返回

请求时需提供品种合约代码（symbol）、时间周期（period）、基准日期（date）以及是否包含最新动态 K 线（withlast）。 返回结果中，Obj 字段包含以分号分隔的 K 线数据字符串，每组数据内部以逗号分隔，依次代表：时间戳、开盘价、最高价、最低价、收盘价、持仓量（部分品种）、成交量。数据排序方向为从开始时间向结束时间排列。

使用场景

• 量化交易回测：获取历史 K 线数据，用于编写和验证量化交易策略，进行历史行情回测。
• 金融图表绘制：为金融资讯类 App 或网站提供历史 K 线数据源，用于绘制 K 线图表及技术指标分析。
• 市场数据分析：供金融研究人员或开发者进行历史价格走势分析、波动率计算及学术研究。

使用说明与限制

• 接口返回的数据时间跨度受周期影响：1分钟周期最多返回近30天数据，5分钟及小时周期最多180天，日线最多10年，周线近2年，月线近5年。
• 接口提供的数据仅供历史行情查询与技术分析参考，不构成任何投资建议，不得用于预测市场走势或引导实际交易投注。
• 需注意不同品种的交易时间差异，非交易时段可能无数据返回；请根据返回的状态码（Code）和提示信息（Msg）处理异常情况。