POST公開中finance-a-shares-ranking

A株ランキング

導入ドキュメント

インターフェースの紹介

このインターフェイスは、中国の A 株市場 (上海および深センのメインボード、科学技術イノベーションボード、GEM、北京証券取引所を含む) のリアルタイムの株式ランキングデータを提供します。開発者は、ソートフィールド（騰落率、出来高、出来高、回転率、株価収益率など）とソート方向を指定することで、特定市場の個別銘柄のランキングリストを取得できます。このデータには、銘柄コード、銘柄名、リアルタイム価格、増減、取引量、高値と安値の始値と終値などの主要な市場指標が含まれており、財務情報ダッシュボードや定量的スクリーニングツールの構築に適しています。

該当するシナリオ

財務情報アプリケーション: 今日の上昇リスト、下落リスト、アクティブな取引リスト、その他のリアルタイムの注目セクターを表示します。
定量的取引支援: 特定の期間 (5 日/20 日) の出来高比率、回転率、または騰落率に基づいて予備的な銘柄を選択します。
投資分析ツール: 市場価値、株価収益率 (PE)、株価純資産倍率 (PB) およびその他のファンダメンタルズに基づいた並べ替えクエリサービスをユーザーに提供します。
市場監視の大画面: 特定の市場 (科学技術イノベーション委員会や北京証券取引所のみなど) における資本の流れと変動をリアルタイムで監視します。

リクエストと返品の手順

リクエスト方法: POST 主要なパラメータ:

market (必須): 市場範囲、オプションの hs_a (上海および深セン A 株)、kcb (科学技術イノベーション委員会)、cyb (GEM)、hs_bjs (北部証券取引所) などを指定します。
sort (必須): 並べ替え基準。changeRate (増減率)、volume (取引量)、value (取引金額)、pe (株価収益率)、changes_5d (5 日間の増減) など、10 を超えるディメンションをサポートします。
asc: ソート順序。0 は逆順 (デフォルト、大きいものから小さいものへ)、1 は順方向です。
page / limit: ページング制御。ページごとに最大 100 個の項目を返すことができます。

結果を返す:

code: ビジネスステータスコード、200 は成功を意味します。
data.list: symbol (コード)、name (名前)、price (現在価格)、changeRate (増減率)、volume (取引量)、update_time (タイムスタンプ) およびその他のフィールドを含む株式オブジェクトの配列。

提案へのアクセス

キャッシュ戦略: 市場データは頻繁に変更されます。高頻度の無効なリクエストを回避するために、ビジネスニーズに応じてフロントエンドで適切なポーリング間隔 (3 ～ 5 秒など) を設定することをお勧めします。
市場の選択: ビジネスに必要な市場範囲を明確にします。マザーボードのみに注目する必要がある場合は、データ送信量を削減し、応答速度を向上させるために hs_a を指定してください。
例外処理: 返された code フィールドを検証する必要があります。 200 でない場合は、エラープロンプトの「msg」情報を読んでください。 HTTP ステータスコードとビジネスステータスコードの区別に注意してください。

実装サンプルコード

Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。

リクエスト例

{
  "sort": "排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序，amplitude 振幅排序， turnOver 换手率排序...",
  "asc": "排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0",
  "page": "页码，默认1",
  "limit": "每页条数，最大100条，默认10",
  "market": "市场代码，可选：hs_a 沪深A股 ，hs_b 沪深B股，hs_bjs 北交所，kcb 科创板，cyb 创业板，hs 沪深所有（AB股全包含）"
}

レスポンス例

{
  "msg": "成功",
  "code": 200,
  "taskNo": "202960247220113090298671",
  "data": {
    "list": [
      {
        "volume": "148761581",
        "symbol": "sh601138",
        "high": "22.860",
        "update_time": 1713324600,
        "low": "21.740",
        "price": "22.410",
        "change": "0.6",
        "name": "工业富联",
        "preclose": "21.810",
        "changeRate": "2.751032",
        "value": "3319659472.000",
        "open": "22.500"
      }
    ]
  }
}

リクエスト項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
type	string	object
properties	object	{...}
properties.sort	object	{...}
properties.sort.type	string	string
properties.sort.description	string	排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序，amplitude 振幅排序， turnOver 换手率排序，volumeRatio 量比排序，pe 市盈率排序，pb 市净率排序，totalShare 总市值排序，changes_5m 五分钟涨跌幅排序， aov_5m 五分钟振幅排序，turnover_5m 五分钟换手率排序，changes_5d aov_5d turnover_5d 为五日数据，changes_20d aov_20d turnover_20d 为20日数据
properties.asc	object	{...}
properties.asc.type

レスポンス項目

以下の項目はサンプル 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-ranking' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "sort": "排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序，amplitude 振幅排序， turnOver 换手率排序...",\n "asc": "排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0",\n "page": "页码，默认1",\n "limit": "每页条数，最大100条，默认10",\n "market": "市场代码，可选：hs_a 沪深A股，hs_b 沪深B股，hs_bjs 北交所，kcb 科创板，cyb 创业板，hs 沪深所有（AB股全包含）"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/finance-a-shares-ranking" payload = { "sort": "排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序，amplitude 振幅排序， turnOver 换手率排序...", "asc": "排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0", "page": "页码，默认1", "limit": "每页条数，最大100条，默认10", "market": "市场代码，可选：hs_a 沪深A股，hs_b 沪深B股，hs_bjs 北交所，kcb 科创板，cyb 创业板，hs 沪深所有（AB股全包含）" } 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-ranking" payload := []byte("{\n \"sort\": \"排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序，amplitude 振幅排序， turnOver 换手率排序...\",\n \"asc\": \"排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0\",\n \"page\": \"页码，默认1\",\n \"limit\": \"每页条数，最大100条，默认10\",\n \"market\": \"市场代码，可选：hs_a 沪深A股，hs_b 沪深B股，hs_bjs 北交所，kcb 科创板，cyb 创业板，hs 沪深所有（AB股全包含）\"\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 涨跌率排序，volume 成交量排序，value 成交额排序，amplitude 振幅排序， turnOver 换手率排序...\",\n \"asc\": \"排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0\",\n \"page\": \"页码，默认1\",\n \"limit\": \"每页条数，最大100条，默认10\",\n \"market\": \"市场代码，可选：hs_a 沪深A股，hs_b 沪深B股，hs_bjs 北交所，kcb 科创板，cyb 创业板，hs 沪深所有（AB股全包含）\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/finance-a-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-a-shares-ranking'; $payload = "{\n \"sort\": \"排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序，amplitude 振幅排序， turnOver 换手率排序...\",\n \"asc\": \"排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0\",\n \"page\": \"页码，默认1\",\n \"limit\": \"每页条数，最大100条，默认10\",\n \"market\": \"市场代码，可选：hs_a 沪深A股，hs_b 沪深B股，hs_bjs 北交所，kcb 科创板，cyb 创业板，hs 沪深所有（AB股全包含）\"\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;

A株ランキング

導入ドキュメント

インターフェースの紹介

該当するシナリオ

リクエストと返品の手順

提案へのアクセス

実装サンプルコード

リクエスト例

レスポンス例

リクエスト項目

レスポンス項目

Shell 例

Python 例

Go 例

Java 例

PHP 例

オンライン試用