Usage Cost
5 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/finance-a-shares-rankingcURL Example
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}'Python Example
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())Go Example
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))
}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 成交额排序,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 Example
<?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;Response Example
{
"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"
}
]
}
}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 成交额排序,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日数据 | Unspecified |
| asc | string | No | 排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0 | Unspecified |
| page | string | No | 页码,默认1 | Unspecified |
| limit | string | No | 每页条数,最大100条,默认10 | Unspecified |
| market | string | Yes | 市场代码,可选:hs_a 沪深A股 ,hs_b 沪深B股,hs_bjs 北交所,kcb 科创板,cyb 创业板,hs 沪深所有(AB股全包含) | Unspecified |
Request Example
{
"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股全包含)"
}- 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 | 接口返回码【注意:不等于HTTP响应状态码】 | 200 |
| taskNo | string | No | 任务订单号【可反馈服务商复核对应订单】 | 202960247220113090298671 |
| data | object | No | Unspecified | Unspecified |
| data.list | array | No | Unspecified | [{"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"}] |
| data.list[] | object | Unspecified | Unspecified | Unspecified |
Response Example
{
"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"
}
]
}
}API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Introduction
This API provides real-time stock ranking data for China's A-share market (including Shanghai and Shenzhen Main Boards, STAR Market, ChiNext, and Beijing Stock Exchange). Developers can specify sorting fields (e.g., change rate, trading volume, turnover, turnover rate, P/E ratio, etc.) and sorting direction to obtain a list of individual stock rankings within a specific market. The data includes core market indicators such as stock code, name, real-time price, change, trading volume/turnover, and high/low/open/close prices, suitable for building financial news dashboards or quantitative screening tools.
Use Cases
- Financial News Applications: Display real-time hot sectors such as today's top gainers, top losers, and most active stocks.
- Quantitative Trading Assistance: Conduct initial stock screening based on volume ratio, turnover rate, or change over specific periods (5-day/20-day).
- Investment Analysis Tools: Provide users with sorting and query services based on fundamental metrics like market capitalization, P/E ratio, and P/B ratio.
- Market Monitoring Dashboards: Real-time monitoring of capital flows and volatility in specific markets (e.g., STAR Market or Beijing Stock Exchange only).
Request and Response Description
Request Method: POST Key Parameters: