行情快照

POST /v1/quote/snapshot

批量获取标的的行情快照（实时）。一次调用最多 400 个 code，按品类返回相应字段。

聚合实时报价（更轻量）请用 get_stock_quote；分时数据请用 get_rt_data；逐笔成交请用 get_rt_ticker；买卖盘请用 get_order_book。

请求参数

参数	类型	位置	必填	说明
code_list	string[]	请求体	是	标的代码列表，最少 1 个、最多 400 个。格式 <MARKET>.<CODE>，如 HK.09988、US.AAPL。

请求示例

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

响应字段

返回 data.snapshot_list[]，每个元素一份标的快照。字段按类别分组（不适用品类的字段会缺省 / 置 0 / 空字符串）。

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

字段	类型	说明
code	string	标的代码（如 HK.09988）。
name	string	标的名称。
update_time	int64	行情更新时间，毫秒时间戳。
data_date	string	行情交易日，标的市场时区 YYYY-MM-DD。
last_price	double	最新价。
open_price	double	今开。
high_price	double	今高。
low_price	double	今低。
prev_close_price	double	昨收。
close_price_5min	double	最近 5 分钟收盘价。
volume	int64	成交量（股 / 张）。
turnover	double	成交额（货币单位）。
turnover_rate	double	换手率（百分比，例如 1.23 表示 1.23%）。
amplitude	double	振幅（百分比）。
volume_ratio	double	量比。
bid_ask_ratio	double	委比（百分比，正数买盘强、负数卖盘强）。
sec_status	string	证券状态，详见枚举对照表 sec_status
dark_status	string	暗盘状态，详见枚举对照表 dark_status
listing_date	int64	上市日期，毫秒时间戳；缺失为 0。
bid_price	double	买一价。
ask_price	double	卖一价。
bid_vol	int64	买一量。
ask_vol	int64	卖一量。
price_spread	double	价差。
highest52weeks_price	double	52 周最高价（不复权）。
lowest52weeks_price	double	52 周最低价（不复权）。
highest_history_price	double	历史最高价（不复权）。
lowest_history_price	double	历史最低价（不复权）。
suspension	bool	是否停牌。
avg_price	double	均价。
lot_size	int64	每手股数。

品类标志位（用于调用方按位筛取专属字段）

字段	类型	说明
equity_valid	bool	是否正股；为 true 时财务字段才有意义。
index_valid	bool	是否指数。
plate_valid	bool	是否板块。
wrt_valid	bool	是否窝轮 / 牛熊证 / 界内证。
trust_valid	bool	是否信托 / 基金 / REIT。
option_valid	bool	是否期权。
future_valid	bool	是否期货。

正股字段（equity_valid=true 时有意义；其它品类为 0）

字段	类型	说明
issued_shares	int64	总股本（股）。
total_market_val	double	总市值（货币单位）。
outstanding_shares	int64	流通股本（股）。
circular_market_val	double	流通市值（货币单位）。
pe_ratio	double	静态 PE。
pe_ttm_ratio	double	滚动 PE（TTM）。
pb_ratio	double	市净率。
dividend_ttm	double	TTM 股息（每股）。
dividend_ratio_ttm	double	TTM 股息率（百分比）。
dividend_lfy	double	上一财年股息（每股）。
dividend_lfy_ratio	double	上一财年股息率（百分比）。
net_asset	double	净资产。
net_asset_per_share	double	每股净资产。
net_profit	double	净利润（上一财年）。
ey_ratio	double	收益率（EY，百分比）。
earning_per_share	double	每股收益（EPS，上一财年）。

指数字段（index_valid=true）

字段	类型	说明
index_raise_count	int64	成分股上涨家数。
index_fall_count	int64	成分股下跌家数。
index_equal_count	int64	成分股平盘家数。

窝轮 / 牛熊证 / 界内证（wrt_valid=true）

字段	类型	说明
wrt_maturity_date	int64	到期日（秒级时间戳）。
wrt_end_trade	int64	最后交易日（秒级时间戳）。

信托 / 基金 / REIT（trust_valid=true）

字段	类型	说明
trust_aum	double	资产管理规模（AUM）。
trust_dividend_yield	double	股息率（百分比）。
trust_outstanding_units	int64	流通单位数。
trust_netAssetValue	double	单位净值（NAV）。
trust_premium	double	溢价（百分比）。
trust_assetClass	string	资产类别，详见下方 trust_assetClass 枚举表

枚举 trust_assetClass（信托 / 基金 / REIT 资产类别）

取值	含义
STOCK	股票
BOND	债券
COMMODITY	商品
CURRENCY_MARKET	货币市场
FUTURE	期货
SWAP	互换

期权（option_valid=true）

字段	类型	说明
option_strike_price	double	行权价。
option_contract_size	int64	合约规模。
option_open_interest	int64	未平仓量。
option_implied_volatility	double	隐含波动率（百分比）。
delta	double	Δ。
gamma	double	Γ。
vega	double	ν。
theta	double	Θ。
rho	double	ρ。
option_net_open_interest	int64	净未平仓。
option_contract_nominal_value	double	合约名义价值。
option_owner_lot_multiplier	double	正股每手乘数。
option_type	string	期权方向，详见枚举对照表 option_type
option_contract_multiplier	int64	合约乘数。
index_option_type	int32	指数期权类型。
option_expiry_date_distance	int64	距到期日天数（已过期为负数）。
option_area_type	string	期权行权类型，详见枚举对照表 option_area_type

期货（future_valid=true）

字段	类型	说明
future_last_settle_price	double	上一结算价。
future_position	int64	持仓。
future_position_change	int64	持仓变化。

时段字段（盘前 / 盘后 / 夜盘；非该时段为 0）

字段	类型	说明
pre_price / pre_high_price / pre_low_price	double	盘前价 / 高 / 低。
pre_volume / pre_turnover	int64 / double	盘前成交量 / 额。
pre_change_val / pre_change_rate	double	盘前涨跌额 / 涨跌幅（百分比）。
pre_amplitude	double	盘前振幅（百分比）。
after_price / after_high_price / after_low_price	double	盘后价 / 高 / 低。
after_volume / after_turnover	int64 / double	盘后成交量 / 额（SH 科创板自动并入 kcb 段）。
after_change_val / after_change_rate	double	盘后涨跌额 / 涨跌幅（百分比）。
after_amplitude	double	盘后振幅（百分比）。
overnight_price / overnight_high_price / overnight_low_price	double	夜盘价 / 高 / 低。
overnight_volume / overnight_turnover	int64 / double	夜盘成交量 / 额。
overnight_change_val / overnight_change_rate	double	夜盘涨跌额 / 涨跌幅（百分比）。
overnight_amplitude	double	夜盘振幅（百分比）。

限制范围

• 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	马来西亚衍生品	期货

错误码

ret_code	error.code	触发条件	处理建议
0	—	成功（含部分 code 被识别为非法但仍有合法返回）	调用方按 data.snapshot_list[].code 与请求 code_list 比对，识别被丢弃的 code
-3	invalid_parameter	缺 code_list / 元素数为 0 / 元素数 > 400 / 元素非字符串	校正请求体后重试
-4	internal_error	网关构造后端请求失败	重试；持续失败请联系网关侧
-6	internal_error	网关响应转换失败	重试；持续失败请联系网关侧
-7	invalid_symbol	code_list 全部 code 都无法解析（前缀不支持 / 代码不存在）	检查市场前缀是否在限制范围内；通过 search 接口确认代码合法性

响应示例

{
  "ret_code": 0,
  "ret_msg": "",
  "data": {
    "snapshot_list": [
      {
        "code": "HK.09988",
        "name": "阿里巴巴-W",
        "update_time": 1748846399000,
        "data_date": "2026-06-02",
        "last_price": 128.7,
        "open_price": 129.4,
        "high_price": 130.5,
        "low_price": 128.0,
        "prev_close_price": 129.2,
        "volume": 30568400,
        "turnover": 3947123456.0,
        "turnover_rate": 0.16,
        "equity_valid": true,
        "issued_shares": 19061235690,
        "total_market_val": 2453181113703.0,
        "pe_ratio": 20.595,
        "pe_ttm_ratio": 16.823,
        "pb_ratio": 1.853,
        "earning_per_share": 6.250,
        "listing_date": 1574697600000,
        "lot_size": 100,
        "sec_status": "NORMAL",
        "dark_status": "N/A",
        "option_type": "",
        "option_area_type": ""
      },
      {
        "code": "BMD.FCPOmain",
        "name": "棕榈油主连",
        "update_time": 1748846399000,
        "data_date": "2026-06-02",
        "last_price": 4521.0,
        "future_valid": true,
        "future_last_settle_price": 4537.0,
        "future_position": 95578,
        "future_position_change": 22908,
        "sec_status": "NORMAL",
        "option_type": "",
        "option_area_type": ""
      },
      {
        "code": "HK.TCH260629C390000",
        "name": "腾讯控股 260629 390.00 购",
        "update_time": 1748846399000,
        "data_date": "2026-06-02",
        "last_price": 13.42,
        "option_valid": true,
        "option_strike_price": 390.0,
        "option_contract_size": 100,
        "option_open_interest": 243,
        "option_implied_volatility": 33.718,
        "delta": 0.612,
        "gamma": 0.018,
        "vega": 0.421,
        "theta": -0.087,
        "rho": 0.176,
        "option_contract_multiplier": 100,
        "option_expiry_date_distance": 26,
        "index_option_type": 1,
        "option_type": "CALL",
        "option_area_type": "AMERICAN",
        "sec_status": "NORMAL"
      }
    ]
  }
}