POSTPublicfund-new-list

Newly Launched Funds List

Usage Cost

10 coins/call

Try it online

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

Documentation

API Overview

This API is used to retrieve a list of newly issued funds in the current market. It supports filtering by sales status (available/unavailable) and provides pagination. The returned data includes core fields such as fund code, name, type, fund manager, subscription start and end dates, minimum subscription amount, and fee rates, helping developers quickly integrate new fund issuance information.

Use Cases

Financial News Platforms: Display the latest issued fund products to enrich content libraries.
Wealth Management Apps: Provide users with new fund subscription reminders and comparison features.
Investment Advisory Systems: Analyze the market distribution and type trends of newly issued funds.

Request and Response Details

Request Method: POST
Key Parameters:
saleStatus: Sales status, true for available for sale, false for not available for sale.
pageNo: Page number, defaults to 1.
pageSize: Number of records per page, defaults to 10, maximum 50.
Response Result:
data.data: Array of fund objects, including fundCode (fund code), fundName (fund name), beginDate (subscription start date), endDate (subscription end date), fundManagerName (fund manager), etc.
data.count: Total number of records, used for frontend pagination calculation.

Integration Suggestions

Pagination Handling: It is recommended to implement frontend pagination based on data.count and pageSize to avoid requesting too much data at once.
Caching Strategy: Newly issued fund data updates relatively infrequently; it is recommended to cache list data for a short period (e.g., 1-4 hours) to reduce API call frequency.
Status Filtering: If only displaying purchasable products, please set saleStatus to true to improve user conversion rates.

Integration Examples

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

Request Example

{
  "saleStatus": "销售状态，true为可售，false为不可售",
  "pageNo": "页码，默认1",
  "pageSize": "每页记录数，默认10，最大50"
}

Response Example

{
  "code": 200,
  "msg": "成功",
  "taskNo": "492823910191448773171202",
  "data": {
    "data": [
      {
        "fundType": "混合型-偏股",
        "beginDate": "2024-07-08",
        "fundCode": "021370",
        "endDate": "2024-08-02",
        "fundOriginalFee": "",
        "minPurchase": "10",
        "fundDiscountFee": "0.00%",
        "saleStatus": true,
        "fundManagerName": "孙蒙",
        "fundName": "华夏智胜优选混合发起式C"
      }
    ],
    "limit": "20",
    "count": 144,
    "page": "1"
  }
}

Request Fields

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

Path	Type	Sample
type	string	object
properties	object	{...}
properties.saleStatus	object	{...}
properties.saleStatus.type	string	string
properties.saleStatus.description	string	销售状态，true为可售，false为不可售
properties.pageNo	object	{...}
properties.pageNo.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-new-list' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "saleStatus": "销售状态，true为可售，false为不可售",\n "pageNo": "页码，默认1",\n "pageSize": "每页记录数，默认10，最大50"\n}'

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