fund-yield

基金走勢數據

線上除錯取得 API Key

呼叫價格

10 匠幣/次

快速接入請求欄位響應欄位介面簡介

快速接入

保持統一返回結構，直接透過服務端發起請求即可接入。

POSThttps://openapi.toolkk.com/v1/fund-yield

cURL Python Go Java PHP

cURL 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/fund-yield' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "fundCode": "基金代码"\n}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/v1/fund-yield"
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 示例

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://openapi.toolkk.com/v1/fund-yield"
    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 示例

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-yield"))
            .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/fund-yield';
$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;

響應示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "data": {
      "fundType": "BLEND",
      "fundIndexYieldDesc": [],
      "success": true,
      "lastYear": "14.6700",
      "lastMonth": "3.2700",
      "serverTime": 1788923928000,
      "lastHalfYear": "14.3600",
      "fundAndIndexYieldVoPair": [
        {
          "code": "PRODUCT_ID-002849",
          "codeType": "PRODUCT_ID",
          "name": "金信智能中国2025混合A",
          "trendType": "PRODUCT_ID-002849",
          "fundTrends": [
            {
              "code": "PRODUCT_ID-002849",
              "reportDate": 1780848000000,
              "codeType": "PRODUCT_ID",
              "name": "金信智能中国2025混合A",
              "value": "2.3912",
              "growRate": "0.000000"
            },
            {
              "code": "PRODUCT_ID-002849",
              "reportDate": 1780934400000,
              "codeType": "PRODUCT_ID",
              "name": "金信智能中国2025混合A",
              "value": "2.4172",
              "growRate": "0.011600"
            },
            {
              "code": "PRODUCT_ID-002849",
              "reportDate": 1781020800000,
              "codeType": "PRODUCT_ID",
              "name": "金信智能中国2025混合A",
              "value": "2.4387",
              "growRate": "0.009400"
            }
          ]
        },
        {
          "code": "BLEND",
          "codeType": "FUND_TYPE",
          "name": "同类均值",
          "trendType": "FUND_TYPE-BLEND",
          "fundTrends": [
            {
              "code": "BLEND",
              "reportDate": 1780848000000,
              "codeType": "FUND_TYPE",
              "name": "同类均值",
              "value": "100.000000",
              "growRate": "0.000000"
            },
            {
              "code": "BLEND",
              "reportDate": 1780934400000,
              "codeType": "FUND_TYPE",
              "name": "同类均值",
              "value": "100.000000",
              "growRate": "0.021000"
            },
            {
              "code": "BLEND",
              "reportDate": 1781020800000,
              "codeType": "FUND_TYPE",
              "name": "同类均值",
              "value": "100.000000",
              "growRate": "-0.011700"
            }
          ]
        },
        {
          "code": "sz399300",
          "codeType": "INDEX_CODE",
          "name": "沪深300",
          "trendType": "INDEX_CODE-sz399300",
          "fundTrends": [
            {
              "code": "sz399300",
              "reportDate": 1780848000000,
              "codeType": "INDEX_CODE",
              "name": "沪深300",
              "value": "100.000000",
              "growRate": "0.000000"
            },
            {
              "code": "sz399300",
              "reportDate": 1780934400000,
              "codeType": "INDEX_CODE",
              "name": "沪深300",
              "value": "100.000000",
              "growRate": "0.018700"
            },
            {
              "code": "sz399300",
              "reportDate": 1781020800000,
              "codeType": "INDEX_CODE",
              "name": "沪深300",
              "value": "100.000000",
              "growRate": "-0.011300"
            }
          ]
        }
      ],
      "lastWeek": "-1.3500"
    },
    "msg": "成功",
    "success": true,
    "code": 200
  }
}

鑑權方式: 請求頭傳入 X-API-Key
預設限流: 60 次/分鐘
超時時間: 5000 ms

接入建議

服務端呼叫時，將 API Key 放在 X-API-Key 請求頭中。

建議按 response code 與業務欄位雙重判斷呼叫結果。

高頻呼叫場景請結合速率限制與重試策略使用。

請求欄位

從伺服器發起請求，並在 X-API-Key 標頭中傳入金鑰。

請求欄位

欄位來自介面結構定義。未提供的說明和範例會標為未標註。

欄位路徑	型別	必填	說明	示例值
fundCode	`string`	是	基金代码	`未標註`

請求示例

{
  "fundCode": "基金代码"
}

鑑權方式: 請求頭傳入 X-API-Key
預設限流: 60 次/分鐘
超時時間: 5000 ms

響應欄位

範例用於理解回傳結構，實際結果以介面回傳為準。

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	必填	說明	示例值
code	`string`	未標註	未標註	`SUCCESS`
message	`string`	未標註	未標註	`success`
data	`object`	未標註	未標註	`{...}`
data.data	`object`	未標註	未標註	`{...}`
data.data.fundType	`string`	未標註	未標註	`BLEND`
data.data.fundIndexYieldDesc	`array`	未標註	未標註	`[]`
data.data.success	`boolean`	未標註	未標註	`true`
data.data.lastYear	`string`	未標註	未標註	`14.6700`
data.data.lastMonth	`string`	未標註	未標註	`3.2700`
data.data.serverTime	`number`	未標註	未標註	`1788923928000`
data.data.lastHalfYear	`string`	未標註	未標註	`14.3600`
data.data.fundAndIndexYieldVoPair	`array`	未標註	未標註	[{"code":"PRODUCT_ID-002849","codeType":"PRODUCT_ID","name":"金信智能中国2025混合A","trendType":"PRODUCT_ID-002849","fundTrends":[{"code":"PRODUCT_ID-002849","reportDate":1780848000000,"codeType":"PRODUCT_ID","name":"金信智能中国2025混合A","value":"2.3912","growRate":"0.000000"},{"code":"PRODUCT_ID-002849","reportDate":1780934400000,"codeType":"PRODUCT_ID","name":"金信智能中国2025混合A","value":"2.4172","growRate":"0.011600"},{"code":"PRODUCT_ID-002849","reportDate":1781020800000,"codeType":"PRODUCT_ID","name":"金信智能中国2025混合A","value":"2.4387","growRate":"0.009400"}]},{"code":"BLEND","codeType":"FUND_TYPE","name":"同类均值","trendType":"FUND_TYPE-BLEND","fundTrends":[{"code":"BLEND","reportDate":1780848000000,"codeType":"FUND_TYPE","name":"同类均值","value":"100.000000","growRate":"0.000000"},{"code":"BLEND","reportDate":1780934400000,"codeType":"FUND_TYPE","name":"同类均值","value":"100.000000","growRate":"0.021000"},{"code":"BLEND","reportDate":1781020800000,"codeType":"FUND_TYPE","name":"同类均值","value":"100.000000","growRate":"-0.011700"}]},{"code":"sz399300","codeType":"INDEX_CODE","name":"沪深300","trendType":"INDEX_CODE-sz399300","fundTrends":[{"code":"sz399300","reportDate":1780848000000,"codeType":"INDEX_CODE","name":"沪深300","value":"100.000000","growRate":"0.000000"},{"code":"sz399300","reportDate":1780934400000,"codeType":"INDEX_CODE","name":"沪深300","value":"100.000000","growRate":"0.018700"},{"code":"sz399300","reportDate":1781020800000,"codeType":"INDEX_CODE","name":"沪深300","value":"100.000000","growRate":"-0.011300"}]}]

介面簡介

介面功能、應用情境、使用限制與常見問題。

介面簡介

本介面提供基於基金程式碼的金融資料查詢服務。輸入基金程式碼後，返回該基金的型別（如混合、股票、債券等）、不同時間維度（近一週、一月、一季、半年、一年）的漲跌幅資料，以及包含具體日期和淨值的基金歷史走勢列表。資料適用於需要展示基金業績表現的應用場景。

適用場景

金融資訊APP：在基金詳情頁展示近期業績表現和歷史淨值曲線。
投顧分析工具：快速對比不同基金在特定週期內的收益率變化。
個人記賬/理財軟體：幫助使用者追蹤持有基金的階段性盈虧情況。
資料視覺化大屏：作為後端資料來源，渲染基金長期走勢圖表。

請求與返回說明

請求方式：POST
核心引數：fundCode（字串，必填），即目標基金的唯一程式碼。
返回資料：
fundType：基金分類標識（BLEND混合型, STOCK股票型, INDEX指數型, BOND債券型, CURRENCY貨幣型）。
lastWeek////：各週期漲跌幅數值（注意：返回值為小數形式，展示時需乘以100%轉換為百分比）。

{ "code": "SUCCESS", "message": "success", "data": { "data": { "fundType": "BLEND", "fundIndexYieldDesc": [], "success": true, "lastYear": "14.6700", "lastMonth": "3.2700", "serverTime": 1788923928000, "lastHalfYear": "14.3600", "fundAndIndexYieldVoPair": [ { "code": "PRODUCT_ID-002849", "codeType": "PRODUCT_ID", "name": "金信智能中国2025混合A", "trendType": "PRODUCT_ID-002849", "fundTrends": [ { "code": "PRODUCT_ID-002849", "reportDate": 1780848000000, "codeType": "PRODUCT_ID", "name": "金信智能中国2025混合A", "value": "2.3912", "growRate": "0.000000" }, { "code": "PRODUCT_ID-002849", "reportDate": 1780934400000, "codeType": "PRODUCT_ID", "name": "金信智能中国2025混合A", "value": "2.4172", "growRate": "0.011600" }, { "code": "PRODUCT_ID-002849", "reportDate": 1781020800000, "codeType": "PRODUCT_ID", "name": "金信智能中国2025混合A", "value": "2.4387", "growRate": "0.009400" } ] }, { "code": "BLEND", "codeType": "FUND_TYPE", "name": "同类均值", "trendType": "FUND_TYPE-BLEND", "fundTrends": [ { "code": "BLEND", "reportDate": 1780848000000, "codeType": "FUND_TYPE", "name": "同类均值", "value": "100.000000", "growRate": "0.000000" }, { "code": "BLEND", "reportDate": 1780934400000, "codeType": "FUND_TYPE", "name": "同类均值", "value": "100.000000", "growRate": "0.021000" }, { "code": "BLEND", "reportDate": 1781020800000, "codeType": "FUND_TYPE", "name": "同类均值", "value": "100.000000", "growRate": "-0.011700" } ] }, { "code": "sz399300", "codeType": "INDEX_CODE", "name": "沪深300", "trendType": "INDEX_CODE-sz399300", "fundTrends": [ { "code": "sz399300", "reportDate": 1780848000000, "codeType": "INDEX_CODE", "name": "沪深300", "value": "100.000000", "growRate": "0.000000" }, { "code": "sz399300", "reportDate": 1780934400000, "codeType": "INDEX_CODE", "name": "沪深300", "value": "100.000000", "growRate": "0.018700" }, { "code": "sz399300", "reportDate": 1781020800000, "codeType": "INDEX_CODE", "name": "沪深300", "value": "100.000000", "growRate": "-0.011300" } ] } ], "lastWeek": "-1.3500" }, "msg": "成功", "success": true, "code": 200 } }

基金走勢數據

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

介面簡介

介面簡介

適用場景

請求與返回說明

響應示例

接入建議

基金走勢對比查詢

文本关键词提取（本地算法）

開庭公告檢索

裁判文書檢索

法院公告檢索

審判流程檢索

法院公告詳情查詢

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

響應示例

請求欄位

請求欄位

請求示例

響應欄位

響應欄位

介面簡介

介面簡介

適用場景

請求與返回說明

相關推薦

相關工具

相關 API

響應示例

接入建議

基金走勢對比查詢

文本关键词提取（本地算法）

開庭公告檢索

裁判文書檢索

法院公告檢索

審判流程檢索

法院公告詳情查詢