Usage Cost
5 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/finance-us-shares-rankingcURL Example
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}'Python Example
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())Go Example
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))
}Java Example
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 Example
<?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;Response Example
{
"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"
}
]
}
}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
Request Fields
Fields are read from the API schema. Missing descriptions and examples are marked as unspecified.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| sort | string | Yes | 排序字段,可选:changeRate 涨跌率排序,volume 成交量排序,value 成交额排序 , totalShare 总市值排序 | Unspecified |
| asc | string | No | 排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0 | Unspecified |
| page | string | No | 页码,默认1 | Unspecified |
| limit | string | No | 每页条数,最大100条,默认10 | Unspecified |
| market | string | Yes | 市场代码,可选:all 全部美股 ,tech 科技股,china 中概股,star 明星股 | Unspecified |
Request Example
{
"sort": "排序字段,可选:changeRate 涨跌率排序,volume 成交量排序,value 成交额排序 , totalShare 总市值排序",
"asc": "排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0",
"page": "页码,默认1",
"limit": "每页条数,最大100条,默认10",
"market": "市场代码,可选:all 全部美股 ,tech 科技股,china 中概股,star 明星股"
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
Response Fields
Fields are read from the API schema. Missing descriptions and examples are marked as unspecified.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| msg | string | No | 返回码对应描述 | 成功 |
| code | number | No | 返回码,详见返回码说明 | 200 |
| taskNo | string | No | 本次请求号 | 309443174209760778124907 |
| data | object | No | Unspecified | Unspecified |
| data.list | array | No | Unspecified | [{"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"}] |
| data.list[] | object | Unspecified | Unspecified | Unspecified |
Response Example
{
"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"
}
]
}
}API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Introduction
This API provides a real-time ranking data query service for the US stock market. Developers can specify sorting fields (e.g., change rate, trading volume, turnover, total market cap) and market categories (all, tech stocks, China concept stocks, etc.) to retrieve list data containing core fields such as stock code, name, real-time price, change, high/low/open/close prices, and market capitalization.
Use Cases
- Financial News Applications: Display popular US stock sectors, gainers, or losers lists to enhance user engagement.
- Quantitative Trading Assistance: Monitor capital flows and volatility in specific sectors (e.g., tech stocks, China concept stocks).
- Investment Research Data Analysis: Track market performance of high-volume or high-market-cap individual stocks to aid investment decisions.
Request and Response Description
Request Method: POST Key Parameters:
sort(Required): Sorting basis, options includechangeRate(change rate),volume(trading volume), (turnover), (total market capitalization).