POST已開放finance-a-shares-kline

A股K線

呼叫價格

5 匠幣/次

線上除錯

無需寫程式，瀏覽器中直接發起真實請求

接入文件

介面簡介

本介面提供中國大陸A股市場的歷史K線資料查詢服務。支援從1分鐘到年線的多種時間週期，並可按需返回指定週期的移動平均線（MA）資料。資料包含開盤價、收盤價、最高價、最低價、成交量及成交額等核心欄位，適用於金融終端、量化策略回測及行情視覺化場景。

適用場景

行情軟體開發：為PC端或移動端應用提供實時及歷史K線圖表資料。
量化交易策略：獲取標準化OHLCV資料，用於技術指標計算與策略回測。
金融資料分析：結合均線資料，進行趨勢分析與市場情緒監控。
投教與資訊平臺：展示個股歷史走勢，輔助投資者決策。

請求與返回說明

請求方式：POST 核心引數：

symbol（必填）：股票程式碼，格式如 sh688193。
type（必填）：K線型別，支援 1(1分鐘) 至 86400(年K) 等多種粒度。
limit（選填）：返回資料條數，預設10條。
ma（選填）：均線週期，可選 5,10,15,20,25,30。

返回結果：

code：業務狀態碼，200表示成功。
data.list：K線資料陣列，包含 open（開盤）、close（收盤）、high（最高）、low（最低）、volume（成交量）、amount（成交額）、day（時間）以及可選的 ma_price 和 ma_volume 均線資料。

接入建議

程式碼格式規範：請確保 symbol 引數包含市場字首（如 sh/sz/bj），否則可能導致查詢失敗。
週期選擇最佳化：高頻交易場景建議使用分鐘級資料，長期趨勢分析建議使用日K或周K以減少資料量。
快取策略：歷史K線資料變動頻率低，建議在客戶端或服務端實施適當快取，降低API呼叫成本。
異常處理：請校驗返回的 code 欄位而非僅依賴HTTP狀態碼，確保業務邏輯正確處理空資料或錯誤情況。

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

請求示例

{
  "symbol": "品种代码，如：sh688193",
  "type": "k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，86400...",
  "limit": "返回条数，默认10",
  "ma": "\t返回ma均线，可选值为：5,10,15,20,25,30，可不传"
}

響應示例

{
  "msg": "成功",
  "code": 200,
  "taskNo": "202960247220113090298671",
  "data": {
    "list": [
      {
        "amount": "171325.1414",
        "ma_volume5": 6110,
        "ma_price5": 27.38,
        "volume": "6185",
        "high": "27.880",
        "low": "27.600",
        "day": "2024-04-22 10:05:00",
        "close": "27.790",
        "open": "27.600"
      }
    ]
  }
}

請求欄位

以下欄位根據示例 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	object
properties	object	{...}
properties.msg	object	{...}
properties.msg.type	string	string
properties.msg.example	string	成功
properties.msg.description	string	接口返回码对应的描述信息
properties.code	object	{...}

curl --request POST \ --url 'https://openapi.toolkk.com/v1/finance-a-shares-kline' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "symbol": "品种代码，如：sh688193",\n "type": "k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，86400...",\n "limit": "返回条数，默认10",\n "ma": "\t返回ma均线，可选值为：5,10,15,20,25,30，可不传"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/finance-a-shares-kline" payload = { "symbol": "品种代码，如：sh688193", "type": "k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，86400...", "limit": "返回条数，默认10", "ma": "\t返回ma均线，可选值为：5,10,15,20,25,30，可不传" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/finance-a-shares-kline" payload := []byte("{\n \"symbol\": \"品种代码，如：sh688193\",\n \"type\": \"k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，86400...\",\n \"limit\": \"返回条数，默认10\",\n \"ma\": \"\\t返回ma均线，可选值为：5,10,15,20,25,30，可不传\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"symbol\": \"品种代码，如：sh688193\",\n \"type\": \"k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，86400...\",\n \"limit\": \"返回条数，默认10\",\n \"ma\": \"\\t返回ma均线，可选值为：5,10,15,20,25,30，可不传\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/finance-a-shares-kline")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/finance-a-shares-kline'; $payload = "{\n \"symbol\": \"品种代码，如：sh688193\",\n \"type\": \"k线类型， 1:1分钟，5：五分钟；15：15分钟；30:30分钟，60:60分钟，120:120分钟，240:日K，1200:周K，7200:月K，86400...\",\n \"limit\": \"返回条数，默认10\",\n \"ma\": \"\\t返回ma均线，可选值为：5,10,15,20,25,30，可不传\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;