實時報價

POST /v1/quote/stock-quote

批量獲取標的的實時股票報價（輕量版快照），對齊推送時的 Quote 基礎報價。字段集相比 get_market_snapshot 更精簡，適合多標的輪詢。

請求參數

參數	類型	位置	必填	說明
`code_list`	string[]	請求體	是	標的代碼列表。

請求示例

bash

curl -s -X POST "$ip/v1/quote/stock-quote" \
  -H "Content-Type: application/json" \
  -H "X-Futu-Client-Nnid: 76879657" \
  -d '{"code_list":["HK.09988","BMD.FCPOmain","HK.TCH260629C390000"]}' | jq

響應字段

返回 data.quote_list[]，每個元素一份標的報價。不適用品類的字段統一返回 0 / 空字符串，子對象字段集穩定。

通用字段（所有品類返回）

字段	類型	說明
code	string	標的代碼（如 `HK.09988`）。
name	string	標的名稱。
data_time	int64	行情交易所時間，毫秒時間戳。
data_date	string	行情交易日，標的市場時區 YYYY-MM-DD。
last_price	double	最新價。
open_price	double	今開。
high_price	double	今高。
low_price	double	今低。
prev_close_price	double	昨收。
volume	int64	成交量（股 / 張）。
turnover	double	成交額（貨幣單位）。
turnover_rate	double	換手率（百分比，例如 `0.353` 表示 0.353%）。
amplitude	double	振幅（百分比）。
sec_status	string	證券狀態，詳見枚舉對照表 sec_status
suspension	bool	是否停牌。
dark_status	string	暗盤狀態，詳見枚舉對照表 dark_status
listing_date	string	上市日期（市場時區 YYYY-MM-DD），缺失為空串。

option_ex_data 子對象（僅期權品類有意義；其它品類字段全為 0 或空串）

字段	類型	說明
strike_price	double	行權價。
contract_size	int64	合約規模。
open_interest	int64	未平倉量。
implied_volatility	double	隱含波動率（百分比）。
premium	double	期權金。
delta	double	Δ。
gamma	double	Γ。
vega	double	ν。
theta	double	Θ。
rho	double	ρ。
net_open_interest	int64	淨未平倉。
contract_nominal_value	double	合約名義價值。
owner_lot_multiplier	int64	正股每手乘數。
contract_multiplier	int64	合約乘數。
option_type	string	期權方向，詳見枚舉對照表 option_type
index_option_type	int32	指數期權類型。
expiry_date_distance	int64	距到期日天數（已過期為負數）。
option_area_type	string	期權行權類型，詳見枚舉對照表 option_area_type

future_ex_data 子對象（僅期貨品類有意義；其它品類字段全為 0）

字段	類型	說明
last_settle_price	double	上一結算價。
position	int64	持倉。
position_change	int64	持倉變化。

pre_market / after_market / overnight 子對象（非該時段為 0）

字段	類型	說明
price	double	時段價。
high_price	double	時段高。
low_price	double	時段低。
volume	int64	時段成交量。
turnover	double	時段成交額。
change_val	double	漲跌額。
change_rate	double	漲跌幅（百分比）。
amplitude	double	振幅（百分比）。

注：SH 科創板的 after_market.volume / after_market.turnover 自動並入科創板盤後段（kcb）。

限制範圍

code 必須是已開通行情前綴必須落在下表 13 個市場內，否則返回 invalid_symbol。
code_list 全部非法 → invalid_symbol；部分非法 → 僅返回合法部分（對照請求與響應可識別被丟棄的 code）。

支持的市場前綴與品類：

前綴	市場	支持品類
HK	香港	正股 / 信託 / REIT / 窩輪 / 牛熊證 / 界內證 / 指數 / 板塊 / ETF / 期權
US	美國	正股 / ETF / 指數
SH	上海	正股 / ETF / 指數 / 板塊
SZ	深圳	正股 / ETF / 指數 / 板塊
BJ	北京	正股 / 指數
SG	新加坡	正股 / ETF / 指數
JP	日本	正股 / 指數
AU	澳洲	正股 / 指數
CA	加拿大	正股 / ETF / 指數
BMS	馬來西亞主板	正股 / 指數
BMD	馬來西亞衍生品	期貨
EC	數字貨幣綜合	CRYPTO
FX	外匯	FOREX

錯誤碼

ret_code	error.code	觸發條件	處理建議
0	—	成功（含部分 code 被識別為非法但仍有合法返回）	調用方按 `data.quote_list[].code` 與請求 `code_list` 比對，識別被丟棄的 code
-3	invalid_parameter	缺 `code_list` / 元素數為 0 / 元素非字符串	校正請求體後重試
-4	internal_error	網關構造後端請求失敗	重試；持續失敗請聯繫網關側
-6	internal_error	網關響應轉換失敗	重試；持續失敗請聯繫網關側
-7	invalid_symbol	`code_list` 全部 code 都無法解析（前綴不支持 / 代碼不存在）	檢查市場前綴是否在限制範圍內；通過 search 接口確認代碼合法性

響應示例

json

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "quote_list": [
      {
        "code": "HK.09988",
        "name": "阿里巴巴-W",
        "data_time": 1780371968000,
        "data_date": "2026-06-02",
        "last_price": 129.0,
        "open_price": 124.1,
        "high_price": 130.3,
        "low_price": 123.4,
        "prev_close_price": 122.8,
        "volume": 68361418,
        "turnover": 8734113777,
        "turnover_rate": 0.356,
        "amplitude": 5.619,
        "sec_status": "NORMAL",
        "suspension": false,
        "dark_status": "N/A",
        "listing_date": "2019-11-26",
        "option_ex_data": {
          "strike_price": 0, "contract_size": 0, "open_interest": 0,
          "implied_volatility": 0, "premium": 0,
          "delta": 0, "gamma": 0, "vega": 0, "theta": 0, "rho": 0,
          "net_open_interest": 0, "contract_nominal_value": 0,
          "owner_lot_multiplier": 0, "contract_multiplier": 0,
          "option_type": "", "index_option_type": 0,
          "expiry_date_distance": 0, "option_area_type": ""
        },
        "future_ex_data": { "last_settle_price": 0, "position": 0, "position_change": 0 },
        "pre_market":  { "price": 0, "high_price": 0, "low_price": 0, "volume": 0, "turnover": 0, "change_val": 0, "change_rate": 0, "amplitude": 0 },
        "after_market": { "price": 0, "high_price": 0, "low_price": 0, "volume": 0, "turnover": 0, "change_val": 0, "change_rate": 0, "amplitude": 0 },
        "overnight":   { "price": 0, "high_price": 0, "low_price": 0, "volume": 0, "turnover": 0, "change_val": 0, "change_rate": 0, "amplitude": 0 }
      },
      {
        "code": "BMD.FCPOmain",
        "name": "原棕榈油期货主连 (2608)",
        "data_time": 1780048799823,
        "data_date": "2026-05-29",
        "last_price": 4535,
        "open_price": 4547,
        "high_price": 4570,
        "low_price": 4518,
        "prev_close_price": 4537,
        "volume": 24953,
        "turnover": 0,
        "turnover_rate": 0,
        "amplitude": 1.146,
        "sec_status": "NORMAL",
        "suspension": false,
        "dark_status": "N/A",
        "listing_date": "",
        "option_ex_data": { "strike_price": 0, "contract_size": 0, "option_type": "", "option_area_type": "" },
        "future_ex_data": { "last_settle_price": 4537, "position": 95578, "position_change": 22908 },
        "pre_market":  { "price": 0, "volume": 0 },
        "after_market": { "price": 0, "volume": 0 },
        "overnight":   { "price": 0, "volume": 0 }
      },
      {
        "code": "HK.TCH260629C390000",
        "name": "腾讯 260629 390.00 购",
        "data_time": 1780363800000,
        "data_date": "2026-06-02",
        "last_price": 48.22,
        "prev_close_price": 48.22,
        "sec_status": "NORMAL",
        "suspension": false,
        "dark_status": "N/A",
        "option_ex_data": {
          "strike_price": 390, "contract_size": 100, "open_interest": 243,
          "implied_volatility": 0, "premium": -5.84,
          "delta": 0, "gamma": 0, "vega": 0, "theta": 0, "rho": 0,
          "net_open_interest": 81, "contract_nominal_value": 46540,
          "owner_lot_multiplier": 1000, "contract_multiplier": 100,
          "option_type": "CALL", "index_option_type": 1,
          "expiry_date_distance": 27, "option_area_type": "AMERICAN"
        },
        "future_ex_data": { "last_settle_price": 0, "position": 0, "position_change": 0 }
      }
    ]
  }
}

實時報價 ​

請求參數 ​

請求示例 ​

響應字段 ​

通用字段（所有品類返回） ​

option_ex_data 子對象（僅期權品類有意義；其它品類字段全為 0 或空串） ​

future_ex_data 子對象（僅期貨品類有意義；其它品類字段全為 0） ​

pre_market / after_market / overnight 子對象（非該時段為 0） ​

限制範圍 ​

錯誤碼 ​

響應示例 ​