美股報價

介面簡介

本介面提供美股市場的實時報價資料查詢服務。透過傳入股票交易程式碼（Symbol），可獲取包括實時價格、開盤價、最高/最低價、成交量、市盈率（PE）、每股收益（EPS）、總市值以及盤後交易資料在內的多維度金融資訊。資料覆蓋主流美股標的，適用於需要整合美股行情展示的業務系統。

適用場景

• 金融資訊應用：在APP或網站中展示美股個股的實時走勢與關鍵財務指標。
• 量化交易輔助：為策略模型提供基礎的價格、成交量及歷史高低點資料參考。
• 投資組合管理：監控持倉股票的當前市值、漲跌額及52周價格區間。
• 市場資料分析：分析個股的流動性（成交量）及估值水平（市盈率、股息率）。

請求與返回說明

請求方式：POST 請求引數：

• symbol (必填)：股票品種程式碼，支援單個或多個程式碼，多個程式碼間以英文逗號分隔（例如：INTC,AAPL）。

返回結果： 成功響應時，data 欄位將包含以股票程式碼為鍵的物件集合。每個物件包含以下核心欄位：

• 價格資訊：price (實時價格), open (開盤價), high/low (當日高低點), preclose (昨收)。
• 交易資料：volume (成交量), volume_avg10 (10日均量), market_value (總市值)。
• 財務指標：pe (市盈率), eps (每股收益), dividend (股息率), shares (總股本)。
• 盤後資料：after_price (盤後價), after_volume (盤後成交量), after_change (盤後漲跌額)。
• 其他：name (中文名稱), trade_time (交易時間), (資料更新時間)。

*注意：所有數值型欄位在響應中均以字串形式返回，前端使用時需自行轉換為數字型別。*

接入建議

1. 批次查詢最佳化：介面支援逗號分隔的多個程式碼查詢，建議將同一頁面的多個股票請求合併為一次呼叫，以減少網路開銷並提高載入速度。
2. 資料重新整理頻率：鑑於實時行情資料的特性，請根據業務需求合理設定前端輪詢間隔，避免過於頻繁的請求導致資源浪費或觸發限流。
3. 異常處理：請始終檢查返回體中的 code 欄位（200表示成功），並妥善處理 msg 中的錯誤提示資訊，確保在個別程式碼查詢失敗時不影響整體頁面渲染。
4. 時區注意：返回的時間欄位（如 trade_time）通常為美東時間或UTC，展示給國內使用者時建議進行時區轉換處理。