ファンド推移データ

インターフェースの紹介

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

該当するシナリオ

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

リクエストと返品の手順

• リクエスト方法: POST
• コアパラメータ: fundCode (文字列、必須)、ターゲットファンドの一意のコードです。
• データを返す:
• fundType: ファンド分類識別子 (BLEND ハイブリッド タイプ、STOCK 株式タイプ、INDEX インデックス タイプ、BOND 債券タイプ、CURRENCY 通貨タイプ)。
• lastWeek/lastMonth/lastQuarter/lastHalf Year/last Year: 各期間の増減値 (注: 戻り値は 10 進形式であり、表示時にパーセンテージに変換するには 100% を掛ける必要があります)。
• fundAndIndexYieldVoPair: ファンド名と fundTrends 配列が含まれます。配列内のオブジェクトには、トレンド チャートを描画するために使用される reportDate (タイムスタンプ) および value (単位正味値) が含まれます。

提案へのアクセス

1. 数値処理: インターフェイスから返される増減率は 10 進数形式 (-0.3620 など) です。フロントエンドで表示する場合は必ずパーセント形式(-36.20%)に変換してください。
2. タイムスタンプ変換: reportDate と serverTime は両方ともミリ秒レベルのタイムスタンプであるため、解析時に標準の日付形式に変換する必要があります。
3. キャッシング戦略: ファンドの正味価値は通常、取引日に基づいて更新され、非取引期間中のデータは変更されません。 API 呼び出しコストを削減し、応答速度を向上させるために、同じ fundCode を持つリクエストに対して適切なキャッシュ時間 (24 時間など) を設定することをお勧めします。
4. 例外処理: 返された「コード」フィールドを確認してください。 200 は成功を意味します。他のステータス コードは、エラー プロンプトの「msg」フィールドと組み合わせる必要があります。