接入文档
接口简介
本接口提供主流外盘期货品种的K线历史行情数据。支持通过指定期货代码及时间周期(如1分钟、5分钟、30分钟、60分钟、日K等),获取包含开盘价、收盘价、最高价、最低价、成交量及时间戳在内的完整OHLCV数据数组。
适用场景
- 量化交易策略回测:获取高频或低频历史数据用于模型训练与验证。
- 实时行情监控:构建外盘期货看盘工具,展示不同时间维度的价格走势。
- 金融数据分析:进行波动率计算、技术指标分析(如MA、MACD)的基础数据源。
请求与返回说明
请求参数:
symbol(必填):期货品种代码,需参照平台提供的代码表填写。type(必填):K线类型,支持 '0'(日K), '1'(1分钟), '5'(5分钟), '30'(30分钟), '60'(60分钟), '120'(120分钟), '240'(240分钟)。limit(选填):返回数据条数,默认为10条。
返回结果:
code/msg:状态码及描述,200表示成功。fields:字段定义数组,顺序对应数据行中的值,通常包含 open, close, high, low, change, changeRate, volume, tick_at。lines:二维数组,每一行代表一根K线,数值顺序与fields一一对应。
接入建议
- 代码映射:请务必先获取并维护最新的期货品种代码表,确保
symbol参数准确。 - 周期选择:根据业务需求选择合适的
type,高频交易建议选择分钟级,趋势分析建议选择日K。 - 数据解析:返回的
lines为纯数值数组,需结合fields数组进行键值映射解析,注意tick_at通常为Unix时间戳。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"symbol": "期货品种代码,详见代码表",
"type": "k线类型,0:日k,1:1分钟,5:五分钟;30:30分钟,60:60分钟,120:120分钟,240:240分钟",
"limit": "返回条数,默认10"
}响应示例
{
"msg": "成功",
"code": 200,
"taskNo": "906962467150026863697586",
"lines": [
[
2.419,
2.422,
2.422,
2.419,
0,
0.12,
65,
1721696400
]
],
"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.code | object | {...} |