導入ドキュメント
インターフェースの紹介
このインターフェイスは、単一ファンドの詳細なパフォーマンス データを提供します。ファンド コードを渡すことにより、さまざまな時間次元でのファンドの上昇と下降 (先週、先月、前四半期、今年、過去 2 年間、過去 3 年間、過去 5 年間)、同じカテゴリの平均上昇と下降、同じカテゴリのランキング、および CSI 300 インデックスと比較した超過収益が返されます。
該当するシナリオ
- 財務情報アプリケーション: ファンドの詳細ページに多次元の過去のパフォーマンス傾向とランキングを表示します。
- 投資調査分析ツール: ファンドの長期安定性を定量的に分析し、同じカテゴリーの平均レベルをベンチマークインデックスと比較します。
- インテリジェントな投資顧問システム: 過去のランキングと利回りに基づいて、高品質のファンドターゲットを選別します。
リクエストと返品の手順
- リクエスト方法: POST
- コアパラメータ:
fundCode(文字列、必須)、クエリ対象のファンドの 6 桁のコードです。 - データを返す:
data.lastWeek/lastMonth/lastQuarterなど: 対応する期間の実際の増減。data.lastWeekRank/lastMonthRankなど: 該当期間の類似ファンド間のランキング。data.lastWeekAvg/lastMonthAvgなど: 対応する期間における類似ファンドの平均騰落率。data.lastWeekHS300など: CSI 300 Index に対する該当期間のパフォーマンス。data.foundDate: ファンド設立日。
提案へのアクセス
- キャッシュ戦略: ファンドの純資産とランキング データは通常、1 日に 1 回更新されます。 API 呼び出しコストを削減するために、同じファンド コードのクエリ結果を少なくとも 24 時間ローカルにキャッシュすることをお勧めします。
- 例外処理: 返された「コード」フィールドを確認してください。 200 以外のステータス コードの場合は、
msgプロンプトに従ってエラー処理を実行する必要があります (ファンド コードが存在しない場合)。 - データ表示: フロントエンドでランキングを表示する場合、ユーザーの読書エクスペリエンスを向上させるために、「lastWeekCount」などの合計数量フィールドを組み合わせてランキングの割合 (「上位 10%」など) を計算することをお勧めします。
実装サンプルコード
Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。
リクエスト例
{
"fundCode": "基金代码"
}レスポンス例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"twoYear": -38.46,
"fiveYearCount": 757,
"allYearHS300": 0,
"nowYearRank": 2499,
"lastWeekCount": 4350,
"lastMonthAvg": -2.15,
"lastMonth": 2.17,
"lastQuarterAvg": -6.32,
"thirdYearAvg": -36.24,
"lastHalfYearAvg": 7.82,
"lastHalfYearRank": 4019,
"nowYearHS300": 0.32,
"lastYearRank": 3688,
"twoYearCount": 3133,
"lastQuarter": -6.31,
"allYearCount": 0,
"fiveYearHS300": -10.25,
"lastWeekAvg": 1.56,
"lastWeekHS300": 0.7,
"foundDate": "2017-12-14",
"lastQuarterHS300": -4.5,
"lastQuarterRank": 2095,
"lastWeek": 6.51,
"lastWeekRank": 34,
"lastMonthHS300": -0.57,
"fiveYear": -27.58,
"lastYearCount": 3822,
"nowYear": -9.91,
"twoYearAvg": -27.66,
"thirdYearCount": 2063,
"lastMonthRank": 227,
"thirdYearRank": 1447,
"nowYearAvg": -7.31,
"fiveYearAvg": 22.95,
"allYearAvg": "",
"twoYearHS300": -17.46,
"lastHalfYearCount": 4171,
"allYearRank": 0,
"lastYearAvg": -17.7,
"thirdYear": -44.54,
"fiveYearRank": 737,
"allYear": -24.08,
"dataDate": "2024-07-31",
"thirdYearHS300": -28.46,
"lastHalfYearHS300": 7.05,
"lastYearHS300": -14.26,
"nowYearCount": 4123,
"twoYearRank": 2547,
"lastYear": -34.4,
"lastQuarterCount": 4295,
"lastHalfYear": -6.16,
"lastMonthCount": 4357
}
}リクエスト項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.fundCode | object | {...} |
| properties.fundCode.type | string | string |
| properties.fundCode.description | string | 基金代码 |
| required | array | "fundCode" |
| required[] | string | fundCode |
レスポンス項目
以下の項目はサンプル 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 | {...} |