Usage Cost
10 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/fund-rankcURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/fund-rank' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "fundCode": "基金代码"\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/fund-rank"
payload = {
"fundCode": "基金代码"
}
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/fund-rank"
payload := []byte("{\n \"fundCode\": \"基金代码\"\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 \"fundCode\": \"基金代码\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/fund-rank"))
.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/fund-rank';
$payload = "{\n \"fundCode\": \"基金代码\"\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
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"twoYear": -38.46,
"fiveYearCount": 757,
"allYearHS300": 0,
"nowYearRank": 2499,
"lastWeekCount": 4350,
"lastMonthAvg": -2.15,
"lastMonth": 2.17,
"lastQuarterAvg": -6.32,
"thirdYearAvg": -36.24,
"lastHalfYearAvg": 7.82,
"lastHalfYearRank": 4019,
"nowYearHS300": 0.32,
"lastYearRank": 3688,
"twoYearCount": 3133,
"lastQuarter": -6.31,
"allYearCount": 0,
"fiveYearHS300": -10.25,
"lastWeekAvg": 1.56,
"lastWeekHS300": 0.7,
"foundDate": "2017-12-14",
"lastQuarterHS300": -4.5,
"lastQuarterRank": 2095,
"lastWeek": 6.51,
"lastWeekRank": 34,
"lastMonthHS300": -0.57,
"fiveYear": -27.58,
"lastYearCount": 3822,
"nowYear": -9.91,
"twoYearAvg": -27.66,
"thirdYearCount": 2063,
"lastMonthRank": 227,
"thirdYearRank": 1447,
"nowYearAvg": -7.31,
"fiveYearAvg": 22.95,
"allYearAvg": "",
"twoYearHS300": -17.46,
"lastHalfYearCount": 4171,
"allYearRank": 0,
"lastYearAvg": -17.7,
"thirdYear": -44.54,
"fiveYearRank": 737,
"allYear": -24.08,
"dataDate": "2024-07-31",
"thirdYearHS300": -28.46,
"lastHalfYearHS300": 7.05,
"lastYearHS300": -14.26,
"nowYearCount": 4123,
"twoYearRank": 2547,
"lastYear": -34.4,
"lastQuarterCount": 4295,
"lastHalfYear": -6.16,
"lastMonthCount": 4357
}
}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 |
|---|---|---|---|---|
| fundCode | string | Yes | 基金代码 | Unspecified |
Request Example
{
"fundCode": "基金代码"
}- 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 |
|---|---|---|---|---|
| code | number | No | 返回码,详见返回码说明 | 200 |
| msg | string | No | 返回码对应描述 | 成功 |
| taskNo | string | No | 本次请求号 | 492823910191448773171202 |
| data | object | No | Unspecified | Unspecified |
| data.twoYear | number | No | 近两年涨跌幅 | -38.46 |
| data.fiveYearCount | number | No | Unspecified | 757 |
| data.allYearHS300 | number | No | Unspecified | 0 |
| data.nowYearRank | number | No | Unspecified | 2499 |
| data.lastWeekCount | number | No | 周同类总数 | 4350 |
| data.lastMonthAvg | number | No | Unspecified | -2.15 |
| data.lastMonth | number | No | 近一月涨跌幅 | 2.17 |
| data.lastQuarterAvg | number | No | Unspecified | -6.32 |
| data.thirdYearAvg | number | No | Unspecified | -36.24 |
| data.lastHalfYearAvg | number |
API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Overview
This API provides detailed performance data for a single fund. By passing the fund code, it returns the fund's gain/loss, average gain/loss for its category, category ranking, and excess return relative to the CSI 300 index across various time dimensions (last week, last month, last quarter, year-to-date, last two years, last three years, last five years).
Use Cases
- Financial News Applications: Display multi-dimensional historical performance trends and rankings on fund detail pages.
- Investment Research Analysis Tools: Quantitatively analyze fund long-term stability, comparing it against category averages and benchmark indices.
- Robo-Advisor Systems: Filter high-quality fund targets based on historical rankings and returns.
Request and Response Details
- Request Method: POST
- Core Parameters:
fundCode(string, required), the six-digit code of the fund to be queried. - Response Data: