POSTPublicfund-sale-list

Available Funds List

Usage Cost

10 coins/call

Try it online

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

Documentation

API Introduction

This API is used to retrieve a list of publicly offered funds currently available for sale in the market. Through a POST request, developers can fetch basic fund information by page number and page size, including fund code, name, unit net value, cumulative net value, daily growth rate, and current subscription and redemption statuses.

Applicable Scenarios

Financial Information Applications: Display daily updated fund market lists.
Investment Advisory Platforms: Filter open-for-subscription and normal-status fund products for users to choose from.
Data Analysis: Build a fundamental fund database to monitor the scale and status changes of products available in the market.

Request and Response Description

Request Method: POST
Key Parameters:
pageNo: Page number, default is 1.
pageSize: Number of records per page, default 10, maximum 50.
Core Return Fields:
fundCode / fundName: Unique fund identifier and name.
netValue / totalValue: Unit net value and cumulative net value.
dayOfGrowth: Daily growth rate percentage.
saleStatus / redeemStatus: Sale status (e.g., "Open for Subscription") and redemption status (e.g., "Open for Redemption").

Integration Suggestions

Pagination Strategy: It is recommended that the front end uses lazy loading or pagination controls to avoid requesting too much data at once, which can affect performance.
Status Filtering: The business layer can filter out funds with suspended subscriptions or redemptions based on the saleStatus and redeemStatus fields to enhance user experience.
Data Caching: Fund net values are typically updated once daily. For scenarios not requiring extremely real-time data, it is recommended to set appropriate local caching to reduce API call frequency.

Integration Examples

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

Request Example

{
  "pageNo": "页码，默认1",
  "pageSize": "每页记录数，默认10，最大50"
}

Response Example

{
  "code": 200,
  "msg": "成功",
  "taskNo": "914968093149234333232591",
  "data": {
    "list": [
      {
        "totalValue": 0.4439,
        "fundCode": "010989",
        "netValue": 0.4439,
        "dayOfGrowth": 1.93,
        "redeemStatus": "开放赎回",
        "saleStatus": "开放申购",
        "fundName": "南方中证房地产ETF发起联接E"
      }
    ]
  }
}

Request Fields

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

Path	Type	Sample
type	string	object
properties	object	{...}
properties.pageNo	object	{...}
properties.pageNo.type	string	string
properties.pageNo.description	string	页码，默认1
properties.pageSize	object	{...}
properties.pageSize.type	string

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-sale-list' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "pageNo": "页码，默认1",\n "pageSize": "每页记录数，默认10，最大50"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/fund-sale-list" payload = { "pageNo": "页码，默认1", "pageSize": "每页记录数，默认10，最大50" } 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-sale-list" payload := []byte("{\n \"pageNo\": \"页码，默认1\",\n \"pageSize\": \"每页记录数，默认10，最大50\"\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 \"pageNo\": \"页码，默认1\",\n \"pageSize\": \"每页记录数，默认10，最大50\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/fund-sale-list")) .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-sale-list'; $payload = "{\n \"pageNo\": \"页码，默认1\",\n \"pageSize\": \"每页记录数，默认10，最大50\"\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;