POST公開中finance-us-shares-ranking

米国株ランキング

利用料金

5 コイン/回

オンライン試用

コード不要、ブラウザから本物のリクエストを送信

導入ドキュメント

インターフェースの紹介

このインターフェイスは、米国株式市場にリアルタイムのランキングデータクエリサービスを提供します。開発者は、ソートフィールド（騰落率、出来高、取引金額、時価総額など）や市場カテゴリ（すべて、テクノロジー株、中国コンセプト株など）を指定することで、銘柄コード、銘柄名、リアルタイム価格、増減、始値と終値の高値と安値、時価総額などのコアフィールドを含むリストデータを取得できます。

該当するシナリオ

財務情報アプリケーション: ユーザーの活動を促進するために、米国株の人気セクター、値上がり者または値上がり者を表示します。
定量的取引支援: 特定のセクター (テクノロジー株、中国のコンセプト株など) の資金の流れと変動を監視します。
投資調査データ分析: 取引高または時価総額の高い株式の市場パフォーマンスを追跡し、投資決定を支援します。

リクエストと返品の手順

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

sort (必須): 並べ替え基準、オプションの changeRate (増減率)、volume (取引高)、value (取引額)、totalShare (合計時価総額)。
market (必須): 市場範囲、オプションの all (すべて)、tech (テクノロジー株)、china (中国コンセプト株)、star (スター株)。
asc: ソート順序、0 は逆順 (デフォルト)、1 は順方向です。
page / limit: ページング制御。ページごとに最大 100 個の項目を返すことができます。

結果を返す: JSON形式でデータを返します。 data.list 配列には、symbol (コード)、name (名前)、price (現在価格)、changeRate (増減率)、volume (取引高) およびその他のフィールドを含む、個々の株式に関する詳細情報が含まれています。

提案へのアクセス

キャッシュ戦略: ランキングデータは頻繁に更新されます。 API 呼び出しの数を減らすために、フロントエンドで短期キャッシュ (1 ～ 5 分など) を設定することをお勧めします。
例外処理: 戻りコード code を確認してください。ステータスコード 200 ではない場合は、エラープロンプトの「msg」フィールドを参照してください。
データ表示: 数値フィールドは文字列タイプであり、フロントエンド表示中に金額とパーセンテージをビジネスニーズに応じて書式設定する必要があることに注意してください。

実装サンプルコード

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

リクエスト例

{
  "sort": "排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序 ， totalShare 总市值排序",
  "asc": "排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0",
  "page": "页码，默认1",
  "limit": "每页条数，最大100条，默认10",
  "market": "市场代码，可选：all 全部美股 ，tech 科技股，china 中概股，star 明星股"
}

レスポンス例

{
  "msg": "成功",
  "code": 200,
  "taskNo": "309443174209760778124907",
  "data": {
    "list": [
      {
        "volume": "215748955",
        "symbol": "NVDA",
        "high": "128.2800",
        "low": "121.3600",
        "price": "128.2800",
        "change": "5.61",
        "name": "英伟达",
        "preclose": "122.6700",
        "changeRate": "4.57",
        "value": "27018856766.0000",
        "open": "121.6600",
        "totalShare": "3155475307911"
      }
    ]
  }
}

リクエスト項目

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

パス	型	サンプル値
type	string	object
properties	object	{...}
properties.sort	object	{...}
properties.sort.type	string	string
properties.sort.description	string	排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序， totalShare 总市值排序
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-us-shares-ranking' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "sort": "排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序， totalShare 总市值排序",\n "asc": "排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0",\n "page": "页码，默认1",\n "limit": "每页条数，最大100条，默认10",\n "market": "市场代码，可选：all 全部美股，tech 科技股，china 中概股，star 明星股"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/finance-us-shares-ranking" payload = { "sort": "排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序， totalShare 总市值排序", "asc": "排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0", "page": "页码，默认1", "limit": "每页条数，最大100条，默认10", "market": "市场代码，可选：all 全部美股，tech 科技股，china 中概股，star 明星股" } 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-us-shares-ranking" payload := []byte("{\n \"sort\": \"排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序， totalShare 总市值排序\",\n \"asc\": \"排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0\",\n \"page\": \"页码，默认1\",\n \"limit\": \"每页条数，最大100条，默认10\",\n \"market\": \"市场代码，可选：all 全部美股，tech 科技股，china 中概股，star 明星股\"\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 成交额排序， totalShare 总市值排序\",\n \"asc\": \"排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0\",\n \"page\": \"页码，默认1\",\n \"limit\": \"每页条数，最大100条，默认10\",\n \"market\": \"市场代码，可选：all 全部美股，tech 科技股，china 中概股，star 明星股\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/finance-us-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-us-shares-ranking'; $payload = "{\n \"sort\": \"排序字段，可选：changeRate 涨跌率排序，volume 成交量排序，value 成交额排序， totalShare 总市值排序\",\n \"asc\": \"排序顺序，0 倒序（由大到小）， 1正序（由小到大），默认0\",\n \"page\": \"页码，默认1\",\n \"limit\": \"每页条数，最大100条，默认10\",\n \"market\": \"市场代码，可选：all 全部美股，tech 科技股，china 中概股，star 明星股\"\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;