如何查询股票历史行情（K 线数据）

本文将介绍如何通过Infoway API查询股票产品的历史 K 线行情，包括 API 参数说明、入参格式、示例代码以及查询结果说明。

1. API 功能简介

Infoway API的批量 K 线查询接口 /stock/batch_kline 提供多产品同时查询历史 K 线的能力，可用于获取分钟、小时、日线等多种周期的行情数据。

该接口适合用于：

• 获取单支股票的历史 K 线
• 同时获取多支股票最近的 K 线
• 根据时间戳向前回溯查询历史数据

2. 接口说明

请求方式：GET
示例 URL 格式：

https://data.infoway.io/stock/batch_kline/{klineType}/{klineNum}/{codes}

其中路径参数为：

• {klineType}：K 线周期类型
• {klineNum}：请求 K 线根数
• {codes}：股票代码列表（逗号分隔）

3. 入参字段说明表

4. 示例请求（Python）

下面是使用 Python requests 包访问接口的示例代码：

import requests
 
api_url = 'https://data.infoway.io/stock/batch_kline/1/10/002594.SZ%2C00285.HK%2CTSLA.US'
 
# 设置请求头
headers = {
    'User-Agent': 'Mozilla/5.0',
    'Accept': 'application/json',
    'apiKey': 'yourApikey'
}
 
# 发送GET请求
response = requests.get(api_url, headers=headers)
 
# 输出结果
print(f"HTTP code: {response.status_code}")
print(f"message: {response.text}")

5. 如何构造你的 API URL

1）选择 K 线周期（klineType）

2）设置查询数量（klineNum）

例如：

• 查询最近 10 根：klineNum=10
• 查询最多 500 根：klineNum=500

3）填写产品代码（codes）

这里指的是交易资产的代码，如果你查询的是股票，则填入对应的股票代码即可。由于Infoway API可查询多个品种，如贵金属、外汇等，对应的产品代码请参考官方文档。

TSLA.US,AAPL.US,9988.HK,600519.SH

注意：多产品查询时，每个产品最大一次只能取 2 根 K 线。

6. 示例返回结果格式说明

接口返回 JSON，主要字段包括：

• code：状态码（0 表示成功）
• msg：提示信息
• data：包含每个产品的 K 线列表

单根 K 线包含数据例如：

{
  "s": "002594.SZ",    //产品代码
  "respList": [
    {
      "t": "1751958000",  //秒时间戳（UTC+8）
      "h": "326.880",    //最高价
      "o": "326.880",    //开盘价
      "l": "326.880",    //最低价
      "c": "326.880",    //收盘价
      "v": "1410",    //成交量
      "vw": "460900.80",    //成交额
      "pc": "0.00%",    //涨跌幅
      "pca": "0.000"    //涨跌额
    }
  ]
}

7. 常见错误与排查