fund-yield

ファンド推移データ

オンライン試用 API Key を取得

利用料金

10 コイン/回

クイックスタートリクエスト項目レスポンス項目 API 紹介

クイックスタート

統一レスポンス形式のまま、バックエンドから直接呼び出せます。

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

導入のポイント

サーバー側から呼び出す際は、X-API-Key ヘッダーに API Key を設定します。

HTTP ステータスと業務フィールドの両方で成功判定するのがおすすめです。

高頻度利用ではレート制限と再試行戦略を併用してください。

リクエスト項目

サーバーからリクエストを送信し、X-API-Keyヘッダーにキーを設定してください。

リクエスト項目

APIスキーマに基づく項目です。説明や例がない場合は未指定と表示します。

パス	型	必須	説明	サンプル値
fundCode	`string`	はい	基金代码	`未指定`

リクエスト例

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

認証方式: リクエストヘッダーに X-API-Key を設定
レート制限: 毎分 60 回
タイムアウト: 5000 ms

レスポンス項目

例はレスポンスの構造を示しています。実際の結果はAPIの応答によって異なります。

レスポンス項目

以下の項目はサンプル 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"}]}]

APIの概要

機能、利用シーン、制約、よくある質問。

インターフェースの紹介

このインターフェイスは、ファンドコードに基づいた財務データクエリサービスを提供します。ファンドコードを入力すると、ファンドタイプ (ハイブリッド、株式、債券など)、さまざまな時間軸 (先週、月、四半期、半年、1 年) での上昇と下降のデータに加え、特定の日付と正味価値を含むファンドの履歴傾向のリストが返されます。このデータは、ファンドのパフォーマンスを実証する必要があるアプリケーションシナリオに適しています。

該当するシナリオ

財務情報アプリ: ファンドの詳細ページに最近のパフォーマンスと過去の純資産曲線を表示します。
投資顧問分析ツール: 特定のサイクル内でのさまざまなファンドの収益率の変化を迅速に比較します。
個人会計/財務管理ソフトウェア: ユーザーが保有する資金の定期的な損益を追跡するのに役立ちます。
データ視覚化の大画面: バックエンドデータソースとして、ファンドの長期トレンドチャートをレンダリングします。

リクエストと返品の手順

リクエスト方法: POST
コアパラメータ: fundCode (文字列、必須)、ターゲットファンドの一意のコードです。
データを返す:
fundType: ファンド分類識別子 (BLEND ハイブリッドタイプ、STOCK 株式タイプ、INDEX インデックスタイプ、BOND 債券タイプ、CURRENCY 通貨タイプ)。

{ "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 例

レスポンス例

リクエスト項目

リクエスト項目

リクエスト例

レスポンス項目

レスポンス項目

APIの概要

インターフェースの紹介

該当するシナリオ

リクエストと返品の手順

レスポンス例

提案へのアクセス

ファンド推移オンライン比較照会、同種ファンドおよびCSI 300指数対比

中国の車両基本情報照会

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

中国の開廷公告検索

中国の裁判文書検索

中国の法院公告検索

中国の審理手続検索

クイックスタート

cURL 例

Python 例

Go 例

Java 例

PHP 例

レスポンス例

リクエスト項目

リクエスト項目

リクエスト例

レスポンス項目

レスポンス項目

APIの概要

インターフェースの紹介

該当するシナリオ

リクエストと返品の手順

関連リソース

関連ツール

関連 API

レスポンス例

提案へのアクセス

ファンド推移オンライン比較照会、同種ファンドおよびCSI 300指数対比

中国の車両基本情報照会

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

中国の開廷公告検索

中国の裁判文書検索

中国の法院公告検索

中国の審理手続検索