米国株価

インターフェースの紹介

このインターフェイスは、米国株式市場にリアルタイムの相場データ クエリ サービスを提供します。株式取引コード（シンボル）を渡すことで、リアルタイム価格、始値、最高値/最低値、出来高、株価収益率（PE）、1株当たり利益（EPS）、時価総額、時間外取引データなどの多次元の財務情報を取得できます。このデータは主流の米国株式ターゲットをカバーしており、米国株式市場の表示を統合する必要があるビジネス システムに適しています。

該当するシナリオ

• 財務情報アプリケーション: 米国株のリアルタイムの傾向と主要な財務指標をアプリまたはウェブサイトに表示します。
• 定量的取引支援: 戦略モデルの基本価格、取引高、過去の最高値と最低値のデータ参照を提供します。
• ポートフォリオ管理: 保有株の現在の市場価値、上昇と下降、および 52 週間の価格範囲を監視します。
• 市場データ分析: 個別銘柄の流動性 (取引量) と評価水準 (株価収益率、配当率) を分析します。

リクエストと返品の手順

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

• symbol (必須): 株記号コード。コンマで区切られた単一または複数のコードをサポートします (例: INTC,AAPL)。

結果を返す: 応答が成功すると、「data」フィールドには銘柄記号をキーとしたオブジェクトのコレクションが含まれます。各オブジェクトには次のコア フィールドが含まれます。

• 価格情報: price (リアルタイム価格)、open (始値)、high/low (その日の高値および安値)、preclose (昨日の終値)。
• 取引データ: volume (取引高)、volume_avg10 (10 日間の平均取引高)、market_value (市場価値の合計)。
• 財務指標: 「pe」 (株価収益率)、「eps」 (1 株当たり利益)、「dividend」 (配当率)、「shares」 (総資本)。
• 時間外データ: after_price (時間外価格)、after_volume (時間外取引高)、after_change (時間外増加または減少)。
• その他: name (中国名)、trade_time (取引時間)、update_time (データ更新時間)。

*注意: すべての数値フィールドは応答内の文字列として返されるため、使用時にフロントエンドによって数値型に変換される必要があります。 *

提案へのアクセス

1. バッチ クエリの最適化: インターフェイスは、カンマで区切られた複数のコード クエリをサポートします。ネットワークのオーバーヘッドを削減し、読み込み速度を向上させるために、同じページに対する複数のストック リクエストを 1 つの呼び出しにマージすることをお勧めします。
2. データ更新頻度: リアルタイムの市場データの特性を考慮して、リソースの無駄を回避したり、リクエストが頻繁すぎるために電流制限がトリガーされたりするのを防ぐために、ビジネス ニーズに応じてフロントエンドのポーリング間隔を合理的に設定してください。
3. 例外処理: 戻り本文の「code」フィールドを常に確認し (200 は成功を示します)、「msg」内のエラー メッセージを適切に処理して、個々のコード クエリが失敗したときにページ全体のレンダリングが影響を受けないようにしてください。
4. タイムゾーンに関する注意: 返される時間フィールド (「trade_time」など) は通常、東部時間または UTC です。国内ユーザー向けに表示する場合はタイムゾーン変換を行うことをお勧めします。