POSTfinance-a-kline-restoration
A股K線復權
A股K線復權
接入文件
介面簡介
本介面提供A股市場股票的K線歷史資料查詢服務,核心能力在於支援復權處理。開發者可透過指定股票程式碼、K線週期(從1分鐘到年線)以及復權型別(前復權、後復權或不復權),獲取包含開盤價、收盤價、最高價、最低價、成交量、成交額及漲跌情況的完整行情陣列。
適用場景
- 量化交易策略回測:使用前復權資料消除除權除息影響,確保價格序列連續性,提高回測準確性。
- 金融圖表展示:為炒股軟體或財經網站提供標準化的K線資料,支援使用者切換檢視不同復權狀態下的走勢。
- 技術形態分析:基於連續的價格資料計算均線、MACD等技術指標,避免因分紅配股導致的資料斷層。
請求與返回說明
請求引數:
symbol(必填):品種程式碼,格式如sh688193。type(必填):K線週期標識。1:1分鐘,5:5分鐘,15:15分鐘,30:30分鐘,60:60分鐘,101:日K,102:周K,103:月K,104:季度K,105:半年K,106:年K。fuquan(必填):復權狀態。0:不復權,1:前復權,2:後復權。limit(選填):返回資料條數,預設為10。
返回結果: 返回一個JSON陣列,每個元素包含以下欄位:
day:資料時間(精確到分鐘)。open,high_px,low_px,close_px:開高低收價格。volume:成交量。value:成交額。change,changeRate:漲跌額與漲跌率。
接入建議
- 復權選擇:進行長期趨勢分析或策略回測時,強烈建議使用前復權 (
fuquan=1),以保持當前價格為基準的歷史價格連續性。 - 週期匹配:注意
type引數的數值編碼,分鐘級與日/周/月級使用不同的編碼段,請嚴格對照文件傳入。 - 資料快取:歷史K線資料變動頻率較低,建議在業務層對非實時資料進行適當快取,以減少API呼叫次數並提升響應速度。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例,便於直接接到現有專案裡。
請求示例
{
"symbol": "品种代码,如:sh688193",
"type": "1:1分钟K线;5:5分钟K线;15:15分钟K线; 30:30分钟K线;60:60分钟K线;101:日K线;102:周K线;103:月K线; 104:季度K线...",
"limit": "返回条数,默认10",
"fuquan": "复权状态,0不复权,1前复权,2后复权"
}響應示例
[
{
"volume": 34239,
"high_px": 22.06,
"change": 0.07,
"close_px": 22.03,
"low_px": 21.93,
"changeRate": 0.32,
"value": 75339657,
"day": "2024-04-19 14:30",
"open": 21.96
}
]請求欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.symbol | object | {...} |
| properties.symbol.type | string | string |
| properties.symbol.description | string | 品种代码,如:sh688193 |
| properties.type | object | {...} |
| properties.type.type | string | string |
響應欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| type | string | array |
| items | object | {...} |
| items.type | string | object |
| items.properties | object | {...} |
| example | array | {"volume":34239,"high_px":22.06,"change":0.07,"close_px":22.03,"low_px":21.93,"changeRate":0.32,"value":75339657,"day":"2024-04-19 14:30","open":21.96} |
| example[] | object | {...} |
| example[].volume | number | 34239 |