POST已開放finance-hk-shares-ranking

港股排行

呼叫價格

5 匠幣/次

線上除錯

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

接入文件

介面簡介

本介面提供港股市場股票的實時行情排行服務。開發者可透過指定排序欄位（目前僅支援漲跌率 changeRate）及排序順序，獲取分頁後的股票列表。返回資料涵蓋股票程式碼、名稱、實時價格、漲跌額、總市值、成交量、市盈率及52周高低點等關鍵財務與交易指標，資料帶有時間戳，便於追蹤更新時效。

適用場景

金融資訊應用：展示港股漲跌幅榜、活躍股榜單，為使用者提供市場熱點概覽。
量化交易輔助：作為策略篩選的初步資料來源，快速定位高波動或特定趨勢的標的。
投資監控看板：整合至個人或機構投資儀表盤，實時監控持倉或關注池外的市場異動。

請求與返回說明

請求方式：POST 核心引數：

sort（必填）：排序欄位，當前僅支援 changeRate（漲跌率）。
asc：排序順序，0 為倒序（由高到低），1 為正序（由低到高），預設為 0。
page：頁碼，預設第 1 頁。
limit：每頁條數，最大支援 100 條，預設 10 條。

返回結果：

code/msg：業務狀態碼及描述，注意區分於 HTTP 狀態碼。
data.list：股票物件陣列，包含 symbol（程式碼）、name（名稱）、price（現價）、changeRate（漲跌率）、market_value（總市值）、volume（成交量）、pe（市盈率）等欄位。
taskNo：任務訂單號，用於問題排查與服務複核。

接入建議

快取策略：鑑於行情資料的高頻變動特性，建議前端根據業務需求設定合理的輪詢間隔（如 3-5 秒），避免高頻請求導致資源浪費或觸發限流。
異常處理：務必校驗返回體中的 code 欄位，僅當 code 為 200 時解析 data 內容；非成功狀態應結合 msg 進行使用者提示或日誌記錄。
資料展示：返回的數值型欄位（如價格、市值）多為字串格式，前端展示時需根據區域習慣進行格式化（如千分位分隔、保留小數位），並注意處理負值（如虧損股的 EPS 或 PE）。

接入示例程式碼

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

請求示例

{
  "sort": "排序字段，目前仅支持：changeRate 涨跌率排序",
  "asc": "排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0",
  "page": "页码，默认1",
  "limit": "每页条数，最大100条，默认10"
}

響應示例

{
  "msg": "成功",
  "code": 200,
  "taskNo": "202960247220113090298671",
  "data": {
    "list": [
      {
        "symbol": "02203",
        "market_value": "75200000.000",
        "change": "0.044",
        "eps": "-0.006",
        "volume": "17180000",
        "shares": "800000000",
        "high": "0.111",
        "update_time": 1713755536,
        "low": "0.064",
        "pe": "-15.6666667",
        "price": "0.094",
        "name": "脑洞科技",
        "ask": "0.094",
        "dividend": "0.000",
        "52week_low": "0.038",
        "preclose": "0.050",
        "bid": "0.091",
        "changeRate": "88.0000000",
        "value": "1586410",
        "open": "0.057",
        "52week_high": "0.210"
      }
    ]
  }
}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
type	string	object
properties	object	{...}
properties.sort	object	{...}
properties.sort.type	string	string
properties.sort.description	string	排序字段，目前仅支持：changeRate 涨跌率排序
properties.asc	object	{...}
properties.asc.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-hk-shares-ranking' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "sort": "排序字段，目前仅支持：changeRate 涨跌率排序",\n "asc": "排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0",\n "page": "页码，默认1",\n "limit": "每页条数，最大100条，默认10"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/finance-hk-shares-ranking" payload = { "sort": "排序字段，目前仅支持：changeRate 涨跌率排序", "asc": "排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0", "page": "页码，默认1", "limit": "每页条数，最大100条，默认10" } 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-hk-shares-ranking" payload := []byte("{\n \"sort\": \"排序字段，目前仅支持：changeRate 涨跌率排序\",\n \"asc\": \"排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0\",\n \"page\": \"页码，默认1\",\n \"limit\": \"每页条数，最大100条，默认10\"\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 \"sort\": \"排序字段，目前仅支持：changeRate 涨跌率排序\",\n \"asc\": \"排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0\",\n \"page\": \"页码，默认1\",\n \"limit\": \"每页条数，最大100条，默认10\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/finance-hk-shares-ranking")) .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-hk-shares-ranking'; $payload = "{\n \"sort\": \"排序字段，目前仅支持：changeRate 涨跌率排序\",\n \"asc\": \"排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0\",\n \"page\": \"页码，默认1\",\n \"limit\": \"每页条数，最大100条，默认10\"\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;