接入文档
接口简介
本接口提供国内内盘期货市场的历史K线数据查询服务。支持通过期货品种代码获取指定周期的行情数据,涵盖开盘价、收盘价、最高价、最低价、成交量等核心指标,数据以数组形式返回,便于前端图表渲染或后端量化计算。
适用场景
- 量化交易策略回测:获取历史分钟级或日线数据,用于策略验证。
- 金融终端开发:为APP或Web端提供实时或历史K线图表数据源。
- 市场行情监控:监控特定期货品种的波动情况,辅助投资决策。
请求与返回说明
请求方式:POST 关键参数:
symbol(必填):期货品种代码,需参考标准代码表。type(必填):K线类型,支持0(日K)、1(1分钟)、5(5分钟)、30/60/120/240分钟等。limit(选填):返回数据条数,默认为10条。
返回结构:
data.lines:二维数组,每项代表一根K线,顺序对应fields定义的字段(如open, close, high, low, change, changeRate, volume, tick_at)。data.fields:字段定义数组,明确lines中各数值的具体含义。code:状态码,200表示成功。
接入建议
- 代码映射:请确保传入的
symbol与交易所标准代码一致,避免查询失败。 - 周期选择:根据业务需求选择合适的
type,高频交易建议选用分钟级数据,趋势分析选用日K。 - 数据解析:返回的K线数据为紧凑数组格式,需结合
fields数组进行键值映射解析,以提升传输效率。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"symbol": "期货品种代码,详见代码表",
"type": "k线类型,0:日k,1:1分钟,5:五分钟;30:30分钟,60:60分钟,120:120分钟,240:240分钟",
"limit": "返回条数,默认10"
}响应示例
{
"msg": "成功",
"taskNo": "075556736233047430019762",
"code": 200,
"data": {
"lines": [
[
552.44,
552.82,
553.2,
552.36,
0.38,
0.07,
2516,
1717178400
]
],
"fields": [
"open",
"close",
"high",
"low",
"change",
"changeRate",
"volume",
"tick_at"
]
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.symbol | object | {...} |
| properties.symbol.type | string | string |
| properties.symbol.description | string | 期货品种代码,详见代码表 |
| properties.type | object | {...} |
| properties.type.type | string | string |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.msg | object | {...} |
| properties.msg.type | string | string |
| properties.msg.example | string | 成功 |
| properties.msg.description | string | 返回码对应描述 |
| properties.taskNo | object | {...} |