外匯K線

介面簡介

本介面提供主流外匯品種的K線歷史與實時行情資料。開發者可透過指定品種程式碼（symbol）及時間週期（type），獲取包含開盤價、收盤價、最高價、最低價、漲跌幅及時間戳的結構化陣列資料，適用於構建金融圖表或進行技術分析。

適用場景

• 量化交易策略回測：獲取不同時間粒度（如1分鐘、5分鐘、日線）的歷史價格序列。
• 金融終端開發：為外匯交易軟體提供實時的蠟燭圖資料來源。
• 市場行情監控：監測特定貨幣對的短期波動趨勢與價格異動。

請求與返回說明

• 請求方式：POST
• 核心引數：
• symbol（必填）：外匯品種程式碼，如 FXINDEX，具體需參照程式碼表。
• type（必填）：K線週期，支援0(日k)、1(1分鐘)、5(5分鐘)、15、30、60、120、240分鐘等。
• limit（選填）：返回資料條數，預設為10條。
• 返回結果：
• data.lines：二維陣列，每項對應一根K線，順序對應 fields 定義的欄位（如 open, close, high, low, change, changeRate, tick_at）。
• data.fields：欄位定義陣列，明確 lines 中數值的具體含義。
• code/msg：介面狀態碼及描述，200表示成功。

接入建議

1. 週期選擇：根據業務需求選擇合適的 type 值，高頻交易建議選擇分鐘級，趨勢分析建議選擇日線。
2. 資料解析：返回的 K 線資料為緊湊陣列格式，請嚴格依據 fields 陣列的順序解析 lines 中的數值，避免錯位。
3. 頻率控制：請注意 API 呼叫頻率限制，建議在客戶端增加快取機制，減少對同一週期資料的重複請求。