POSTPublicfund-bonus

Fund Dividends and Distributions

Usage Cost

10 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

API Overview

This API provides a service to query historical dividend and distribution information for public funds. Developers can retrieve past dividend dates, dividend types (e.g., cash dividends or dividend reinvestment), and specific dividend distribution ratios for a fund by simply providing its standard fund code.

Use Cases

Financial News Applications: Display historical dividend records on fund detail pages to help users assess fund income stability.
Quantitative Analysis Systems: Batch retrieve dividend data for building factor models or backtesting strategies.
Personal Accounting Tools: Automatically synchronize dividend receipt information for held funds to complete asset reports.

Request and Response Details

Request Method: POST
Core Parameter: fundCode (string, required), which is the 6-digit fund code.
Response Structure:
code: Status code; 200 indicates success.
data.list: Array object containing specific dividend records.
date: Dividend record date or distribution date.
type: Dividend type, e.g., “Dividend”.
rate: Dividend distribution ratio value.
fundCode: The corresponding fund code.

Integration Recommendations

Caching Strategy: Fund dividend data is historical data with infrequent changes. It is recommended to cache query results locally (e.g., for 24 hours) to reduce API call frequency and improve response speed.
Error Handling: Please validate the returned code field. If the fund code does not exist or there are no dividend records, the API might return an empty list or a specific error code. Frontend fault tolerance should be implemented.
Data Interpretation: The specific meaning of the rate field (e.g., dividend amount per 10 units) needs to be confirmed in conjunction with the business scenario. It is recommended to add unit descriptions in the UI to enhance user experience.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

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

Response Example

{
  "code": 200,
  "msg": "成功",
  "taskNo": "492823910191448773171202",
  "data": {
    "list": [
      {
        "date": "2016-06-27",
        "fundCode": "000263",
        "rate": 0.2772,
        "type": "分红"
      }
    ]
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
type	string	object
properties	object	{...}
properties.fundCode	object	{...}
properties.fundCode.type	string	string
properties.fundCode.description	string	基金代码
required	array	"fundCode"
required[]	string	fundCode

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
type	string	object
properties	object	{...}
properties.code	object	{...}
properties.code.type	string	number
properties.code.example	number	200
properties.code.description	string	返回码，详见返回码说明
properties.msg	object

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

import os import requests url = "https://openapi.toolkk.com/v1/fund-bonus" 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())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/fund-bonus" 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)) }

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