实时报价

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） ​

限制范围 ​

错误码 ​

响应示例 ​