调用价格
5 匠币/次
快速接入
保持统一返回结构,直接通过服务端发起请求即可接入。
https://openapi.toolkk.com/v1/finance-hk-shares-rankingcURL 示例
curl --request POST \
--url 'https://openapi.toolkk.com/v1/finance-hk-shares-ranking' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "sort": "排序字段,目前仅支持:changeRate 涨跌率排序",\n "asc": "排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0",\n "page": "页码,默认1",\n "limit": "每页条数,最大100条,默认10"\n}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/finance-hk-shares-ranking"
payload = {
"sort": "排序字段,目前仅支持:changeRate 涨跌率排序",
"asc": "排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0",
"page": "页码,默认1",
"limit": "每页条数,最大100条,默认10"
}
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 示例
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/finance-hk-shares-ranking"
payload := []byte("{\n \"sort\": \"排序字段,目前仅支持:changeRate 涨跌率排序\",\n \"asc\": \"排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0\",\n \"page\": \"页码,默认1\",\n \"limit\": \"每页条数,最大100条,默认10\"\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 示例
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 涨跌率排序\",\n \"asc\": \"排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0\",\n \"page\": \"页码,默认1\",\n \"limit\": \"每页条数,最大100条,默认10\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/finance-hk-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 示例
<?php
$endpoint = 'https://openapi.toolkk.com/v1/finance-hk-shares-ranking';
$payload = "{\n \"sort\": \"排序字段,目前仅支持:changeRate 涨跌率排序\",\n \"asc\": \"排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0\",\n \"page\": \"页码,默认1\",\n \"limit\": \"每页条数,最大100条,默认10\"\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;响应示例
{
"msg": "成功",
"code": 200,
"taskNo": "202960247220113090298671",
"data": {
"list": [
{
"symbol": "02203",
"market_value": "75200000.000",
"change": "0.044",
"eps": "-0.006",
"volume": "17180000",
"shares": "800000000",
"high": "0.111",
"update_time": 1713755536,
"low": "0.064",
"pe": "-15.6666667",
"price": "0.094",
"name": "脑洞科技",
"ask": "0.094",
"dividend": "0.000",
"52week_low": "0.038",
"preclose": "0.050",
"bid": "0.091",
"changeRate": "88.0000000",
"value": "1586410",
"open": "0.057",
"52week_high": "0.210"
}
]
}
}示例用于理解返回结构,实际结果以接口返回为准。
- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 60 次/分钟
- 超时时间
- 5000 ms
服务端调用时,将 API Key 放在 X-API-Key 请求头中。
建议按 response code 与业务字段双重判断调用结果。
高频调用场景请结合速率限制与重试策略使用。
请求字段
从服务端发起请求,并在 X-API-Key 请求头中传入密钥。
请求字段
字段来自接口结构定义。未提供的说明和示例会标为未标注。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| sort | string | 是 | 排序字段,目前仅支持:changeRate 涨跌率排序 | 未标注 |
| asc | string | 否 | 排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0 | 未标注 |
| page | string | 否 | 页码,默认1 | 未标注 |
| limit | string | 否 | 每页条数,最大100条,默认10 | 未标注 |
请求示例
{
"sort": "排序字段,目前仅支持:changeRate 涨跌率排序",
"asc": "排序顺序,0 倒序(由大到小), 1正序(由小到大),默认0",
"page": "页码,默认1",
"limit": "每页条数,最大100条,默认10"
}- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 60 次/分钟
- 超时时间
- 5000 ms
响应字段
示例用于理解返回结构,实际结果以接口返回为准。
响应字段
字段来自接口结构定义。未提供的说明和示例会标为未标注。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| msg | string | 否 | 接口返回码对应的描述信息 | 成功 |
| code | number | 否 | 接口返回码【注意:不等于HTTP响应状态码】 | 200 |
| taskNo | string | 否 | 任务订单号【可反馈服务商复核对应订单】 | 202960247220113090298671 |
| data | object | 否 | 未标注 | 未标注 |
| data.list | array | 否 | 未标注 | [{"symbol":"02203","market_value":"75200000.000","change":"0.044","eps":"-0.006","volume":"17180000","shares":"800000000","high":"0.111","update_time":1713755536,"low":"0.064","pe":"-15.6666667","price":"0.094","name":"脑洞科技","ask":"0.094","dividend":"0.000","52week_low":"0.038","preclose":"0.050","bid":"0.091","changeRate":"88.0000000","value":"1586410","open":"0.057","52week_high":"0.210"}] |
| data.list[] | object | 未标注 | 未标注 | 未标注 |
响应示例
{
"msg": "成功",
"code": 200,
"taskNo": "202960247220113090298671",
"data": {
"list": [
{
"symbol": "02203",
"market_value": "75200000.000",
"change": "0.044",
"eps": "-0.006",
"volume": "17180000",
"shares": "800000000",
"high": "0.111",
"update_time": 1713755536,
"low": "0.064",
"pe": "-15.6666667",
"price": "0.094",
"name": "脑洞科技",
"ask": "0.094",
"dividend": "0.000",
"52week_low": "0.038",
"preclose": "0.050",
"bid": "0.091",
"changeRate": "88.0000000",
"value": "1586410",
"open": "0.057",
"52week_high": "0.210"
}
]
}
}接口简介
接口能力、应用场景、使用限制与常见问题。
接口能力
按涨跌率取得港股行情的分页榜单,可选择升序或降序,读取股票代码、名称、价格、涨跌、成交数据及市值等辅助信息。当前sort仅支持changeRate,不能因为结果含成交量或市值就改按这些指标排序。成功结果为data.list对象数组;接口用于取得排行记录,不提供单股代码查询、历史区间筛选、消息推送、异动原因或交易执行。
应用场景
市场概览可展示领涨或领跌记录,并以价格、成交额与市值补充榜单行;观察服务可定时保存查询条件和结果,对比同一代码的变化,再由业务系统提醒;研究页面可把当前记录作为候选标的,另行核查基本信息。分页时行情可能变化,不宜把多次请求直接当成同一时刻的完整市场快照。排名表示所选排序关系,不等于投资价值、推荐程度或未来收益。
从输入到结果
先选涨跌率排序,asc为0时降序、为1时升序;页码默认1,每页默认10且最多100。检查业务状态后遍历 data.list,以 symbol 保留前导零并匹配名称。价格、涨跌、量额和估值等多为字符串,计算前核对空值并解析数值。股本与市值应分别展示,负市盈率不能据此解释为便宜。 update_time 是时间戳但未注明单位和时区,确认前保留原值并记录自己的接收时间。
范围与限制
当前未说明证券全量范围、交易阶段、更新频率、固定延迟、报价币种、成交量单位和涨跌率的数值单位,也未定义估值期间。不要给返回的率值自行追加百分号或换算倍数,股息值为零也不能直接证明无分红。响应没有总条数或末页判据,空页不能证明已取得全市场数据。买卖价只是返回的行情信息,不能当作成交确认或下单价格保证。
常见问题
可以按成交额或市值排序吗?
当前sort仅支持changeRate。成交额、市值可辅助展示,但它们出现在结果中不代表可作为排序条件。
怎样取得领跌记录?
使用涨跌率排序并设置asc为1,从低到高查看;asc为0从高到低。页码与条数按本接口规则设置。
时间戳能直接证明行情实时吗?
不能。当前未给出时间单位、时区或固定延迟。确认口径后再显示时间,并保留应用接收时间供复核。