接入文件
介面簡介
本介面提供主流外盤期貨品種的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 | {...} |