# POST 获取产品的历史/实时K线(Candles)

## 接口说明

该接口是获取股票、加密货币、外汇、能源、商品等所有产品的历史/实时K线(Candles)

## 请求频率

跟其他接口请求频率使用同一个频率限制。具体每秒请求次数根据套餐决定。可以参考[接口限制说明](https://docs.infoway.io/getting-started/api-limitation)

## 错误码说明

参考[HTTP错误码说明](https://docs.infoway.io/getting-started/error-codes/http)

## 接口地址

### 股票接口（包括美股、港股、A股）：

* 基本路径：`/stock/v2/batch_kline`
* 完整路径：`https://data.infoway.io/stock/v2/batch_kline`

### 日本股接口：

* 基本路径：`/japan/v2/batch_kline`
* 完整路径：`https://data.infoway.io/japan/v2/batch_kline`

### 印度股接口：

* 基本路径：`/india/v2/batch_kline`
* 完整路径：`https://data.infoway.io/india/v2/batch_kline`

### 加密货币接口：

* 基本路径：`/crypto/v2/batch_kline`
* 完整路径：`https://data.infoway.io/crypto/v2/batch_kline`

### 外汇、新能源、商品、贵金属、期货等产品接口：

* 基本路径：`/common/v2/batch_kline`
* 完整路径：`https://data.infoway.io/common/v2/batch_kline`

## 请求头

| 参数       | 类型     | 必填 | 描述           |
| -------- | ------ | -- | ------------ |
| `apiKey` | String | 是  | 您套餐中的API Key |

## Request Body入参说明（JSON）

## 入参示例

```json
{
    "klineType":1, //kline类型
    "klineNum":10, //k线数量
    "codes":"TSLA.US,AAPL.US", //查询产品，逗号分隔
    "timestamp":1758553860 //最近截止时间戳（不传默认查询当前最新k）
}
```

<table><thead><tr><th>参数名</th><th>类型</th><th width="111">必填</th><th width="229">描述</th><th>示例值</th></tr></thead><tbody><tr><td><code>klineType</code></td><td>int</td><td>是</td><td>kline类型。1：1分钟k；2：5分钟k；3：15分钟k；4：30分钟k；5：1小时k；6：2小时k；7：4小时k；8：日k；9：周k；10：月k；11：季k；12：年k</td><td><code>1</code></td></tr><tr><td><code>klineNum</code></td><td>int</td><td>是</td><td>查询k线的数量（单产品最大可以查询500根K线；<strong>多产品同时查询只能查询不同产品最近2根k</strong>）</td><td><code>500</code></td></tr><tr><td><code>codes</code></td><td>String</td><td>是</td><td>查询的产品代码，多个之间用逗号分隔(<strong>最多可同时查询100个产品K线</strong>)。可参考<a href="../basic-info/get-symbol-list">产品列表</a></td><td><code>TSLA.US,AAPL.US</code></td></tr><tr><td><code>timestamp</code></td><td>long</td><td>否</td><td><strong>只针对分钟K以及小时K限制，日K及以上类型不限制</strong><br><strong>秒时间戳</strong>，支持根据秒时间戳向前<strong>查询历史kline</strong>，不传默认查询最近的kline（可查询范围根据套餐权限决定）</td><td>1727007864</td></tr></tbody></table>

## 返回示例

```json
{
    "ret": 200,
    "msg": "success",
    "traceId": "19814db2-42f7-4788-9b51-b2001bf17953",
    "data": [
        {
            "s": "TSLA.US",
            "respList": [
                {
                    "t": "1751372340",
                    "h": "298.620",
                    "o": "298.439",
                    "l": "298.100",
                    "c": "298.310",
                    "v": "24329",
                    "vw": "7259092.235",
                    "pc": "-0.02%",
                    "pca": "-0.070"
                },
                {
                    "t": "1751372280",
                    "h": "298.450",
                    "o": "298.090",
                    "l": "298.000",
                    "c": "298.380",
                    "v": "32214",
                    "vw": "9607344.900",
                    "pc": "0.10%",
                    "pca": "0.290"
                }
            ]
        },
        {
            "s": "01810.HK",
            "respList": [
                {
                    "t": "1751270400",
                    "h": "59.950",
                    "o": "59.950",
                    "l": "59.950",
                    "c": "59.950",
                    "v": "23669600",
                    "vw": "1418992520.000",
                    "pc": "0.50%",
                    "pca": "0.300"
                },
                {
                    "t": "1751270340",
                    "h": "59.700",
                    "o": "59.650",
                    "l": "59.650",
                    "c": "59.650",
                    "v": "829002",
                    "vw": "49466778.300",
                    "pc": "-0.08%",
                    "pca": "-0.050"
                }
            ]
        }
    ]
}
```

| 字段名        | 类型     | 必填 | 描述   | 示例值           |
| ---------- | ------ | -- | ---- | ------------- |
| `s`        | String | 是  | 标的代码 | `USDCNY`      |
| `respList` | Array  | 是  | k线列表 | 参考下面的respList |

### respList

| 字段名   | 类型     | 必填 | 描述                  | 示例值          |
| ----- | ------ | -- | ------------------- | ------------ |
| `t`   | String | 是  | 成交时间（秒时间戳，顺序从大到小排列） | `1751270340` |
| `h`   | String | 是  | 最高价                 | `18.01`      |
| `o`   | String | 是  | 开盘价                 | `18.01`      |
| `l`   | String | 是  | 最低价                 | `18.01`      |
| `c`   | String | 是  | 收盘价                 | `18.01`      |
| `v`   | String | 是  | 成交量                 | `18000`      |
| `vw`  | String | 是  | 成交额                 | `20000`      |
| `pc`  | String | 是  | 涨跌幅                 | `0.12%`      |
| `pca` | String | 是  | 涨跌额                 | `0.11`       |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.infoway.io/rest-api/http-endpoints/get-candles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.