POST已开放finance-a-shares-ranking

A股排行

调用价格

5 匠币/次

在线调试

无需写代码，浏览器中直接发起真实请求

接入文档

接口简介

本接口提供中国A股市场（含沪深主板、科创板、创业板及北交所）的实时股票排行数据。开发者可通过指定排序字段（如涨跌率、成交量、成交额、换手率、市盈率等）及排序方向，获取特定市场下的个股排名列表。数据包含股票代码、名称、实时价格、涨跌幅、成交量额及高低开收等核心行情指标，适用于构建金融资讯看板或量化筛选工具。

适用场景

金融资讯应用：展示今日涨幅榜、跌幅榜、成交活跃榜等实时热点板块。
量化交易辅助：基于量比、换手率或特定周期（5日/20日）涨跌幅进行初步选股筛选。
投资分析工具：为用户提供按市值、市盈率（PE）、市净率（PB）等基本面的排序查询服务。
行情监控大屏：实时监控特定市场（如仅科创板或北交所）的资金流向与波动情况。

请求与返回说明

请求方式：POST 关键参数：

market（必填）：指定市场范围，可选 hs_a（沪深A股）、kcb（科创板）、cyb（创业板）、hs_bjs（北交所）等。
sort（必填）：排序依据，支持 changeRate（涨跌率）、volume（成交量）、value（成交额）、pe（市盈率）、changes_5d（5日涨跌幅）等十余种维度。
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;