POST公開中fund-sale-list

販売中ファンド一覧

利用料金

10 コイン/回

オンライン試用

コード不要、ブラウザから本物のリクエストを送信

導入ドキュメント

インターフェースの紹介

このインターフェースは、現在市場で販売されている公的資金のリストデータを取得するために使用されます。 POST リクエストを通じて、開発者は、ファンドコード、名前、ユニット正味価値、累積正味価値、日次増加額、現在のサブスクリプションと償還ステータスなど、ページ番号とページごとの数量ごとに基本的なファンド情報を取得できます。

該当するシナリオ

財務情報アプリケーション: 毎日更新されるファンド市場リストを表示します。
投資顧問プラットフォーム: 定期購入が可能で、ユーザーが選択できる通常のステータスにあるファンド商品を選別します。
データ分析: 基本的なファンドデータベースを構築し、市場で販売されている商品の規模や状況の変化を監視します。

リクエストと返品の手順

リクエスト方法: POST
主要パラメータ:
pageNo: ページ番号、デフォルトは 1 です。
pageSize: ページあたりのレコード数、デフォルトは 10、サポートされる最大値は 50。
コアフィールドを返す:
fundCode / fundName: ファンドの一意の識別子と名前。
netValue / totalValue: 単位正味価値と累積正味価値。
dayOfGrowth: 毎日の成長率。
saleStatus / redeemStatus: 販売ステータス (「定期購入受付中」など) および引き換えステータス (「引き換え受付中」など)。

提案へのアクセス

ページング戦略: 一度に大量のデータを要求してパフォーマンスに影響を与えることを避けるために、フロントエンドで遅延読み込みまたはページング制御を採用することをお勧めします。
ステータスフィルタリング: ビジネスレイヤーは、ユーザーエクスペリエンスを向上させるために、「saleStatus」フィールドと「redeemStatus」フィールドに基づいて、サブスクリプションと償還が停止されているファンドをフィルタリングできます。
データキャッシュ: ファンドの正味価値は通常、1 日に 1 回更新されます。 API 呼び出しの頻度を減らすために、非リアルタイム要件が非常に高いシナリオでは、適切なローカルキャッシュを設定することをお勧めします。

実装サンプルコード

Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。

リクエスト例

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

レスポンス例

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

リクエスト項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
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	string

レスポンス項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
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;