香港株ランキング

インターフェースの紹介

このインターフェイスは、香港株式市場の株式のリアルタイム市場ランキング サービスを提供します。開発者は、並べ替えフィールド (現在はchangeRateのみがサポートされています) と並べ替え順序を指定することにより、ページング ストック リストを取得できます。返されたデータには、銘柄コード、名前、リアルタイム価格、騰落率、時価総額、取引高、株価収益率、52 週間の高値と安値などの主要な財務指標と取引指標が含まれます。データにはタイムスタンプが付けられ、追跡と更新の適時性を容易にします。

該当するシナリオ

• 財務情報アプリケーション: 香港株価の騰落リストとアクティブな株式リストを表示し、市場のホットスポットの概要をユーザーに提供します。
• 定量的取引アシスタント: 戦略スクリーニングのための予備データ ソースとして、ボラティリティの高いターゲットや特定の傾向を迅速に特定します。
• 投資監視ダッシュボード: 個人または機関投資のダッシュボードに統合して、リアルタイムでポジションを監視したり、プール外の市場の動きに注意を払ったりできます。

リクエストと返品の手順

リクエスト方法: POST コアパラメータ:

• sort (必須): 並べ替えフィールド。現在は changeRate (増加率と減少率) のみをサポートしています。
• asc: ソート順序。0 は逆順 (上位から下位へ)、1 は順方向 (下位から上位へ) で、デフォルトは 0 です。
• page: ページ番号、デフォルトのページ 1。
• limit: ページごとの項目数、サポートされる最大項目は 100 項目、デフォルトは 10 項目です。

結果を返す:

• code/msg: ビジネスステータスコードとその説明。HTTPステータスコードとは異なることに注意してください。
• data.list: symbol (コード)、name (名前)、price (現在価格)、changeRate (増減率)、market_value (市場価値の合計)、volume (取引高)、pe (株価収益率) およびその他のフィールドを含む株式オブジェクトの配列。
• taskNo: タスクの順序番号。トラブルシューティングとサービスのレビューに使用されます。

提案へのアクセス

1. キャッシュ戦略: 市場データの高頻度で変化する特性を考慮して、リソースの無駄や高頻度のリクエストによる電流制限のトリガーを避けるために、フロントエンドがビジネス ニーズに応じて適切なポーリング間隔 (3 ～ 5 秒など) を設定することをお勧めします。
2. 例外処理: 戻り本文の code フィールドを必ず確認し、コードが 200 の場合にのみ data コンテンツを解析します。失敗ステータスは、ユーザー プロンプトまたはログ記録用の msg と組み合わせる必要があります。
3. データ表示: 返される数値フィールド (価格、市場価格など) のほとんどは文字列形式です。フロントエンドで表示する場合は、地域の慣習に従って書式設定する必要があり（千の位の区切り、小数点以下の桁数の保持など）、負の値の扱い（赤字株のEPSやPEなど）に注意する必要があります。