Skip to content

行情快照 ​

POST /api/v1.0/quote/snapshot

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

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

请求参数 ​

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

请求示例 ​

bash
curl -s -X POST "https://webapi.futunn.com/api/v1.0/quote/snapshot" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <AccessToken>" \
  -d '{"code_list":["HK.09988","BMD.FCPOmain","HK.TCH260629C390000"]}' | jq

响应字段 ​

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

历史收盘价字段 close_price_* 与 last_price 单位一致,随快照返回,无需新增订阅类型。未取得对应历史数据时,字段可能缺省或为 0;0 不代表实际收盘价。

通用字段(所有品类返回) ​

参数类型说明
dataobject
data.snapshot_listobject[]
data.snapshot_list[].codestring
data.snapshot_list[].namestring
data.snapshot_list[].sc_namestring
data.snapshot_list[].tc_namestring
data.snapshot_list[].update_timeint
data.snapshot_list[].data_datestring
data.snapshot_list[].last_pricenumber
data.snapshot_list[].open_pricenumber
data.snapshot_list[].high_pricenumber
data.snapshot_list[].low_pricenumber
data.snapshot_list[].prev_close_pricenumber
data.snapshot_list[].close_price_5minnumber5 分钟收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_15minnumber15 分钟收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_5daynumber5 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_10daynumber10 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_20daynumber20 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_60daynumber60 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_120daynumber120 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_250daynumber250 日收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_monthnumber1 月收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_yearnumber1 年收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].close_price_3yearnumber3 年收盘价,与 last_price 单位一致;无数据时字段可能缺省或为 0;0 不代表实际收盘价。
data.snapshot_list[].volumeint
data.snapshot_list[].turnovernumber
data.snapshot_list[].turnover_ratenumber
data.snapshot_list[].amplitudenumber
data.snapshot_list[].volume_rationumber
data.snapshot_list[].bid_ask_rationumber
data.snapshot_list[].sec_statusstring
data.snapshot_list[].dark_statusstring
data.snapshot_list[].listing_dateint
data.snapshot_list[].bid_pricenumber
data.snapshot_list[].ask_pricenumber
data.snapshot_list[].bid_volint
data.snapshot_list[].ask_volint
data.snapshot_list[].price_spreadnumber
data.snapshot_list[].highest52weeks_pricenumber
data.snapshot_list[].lowest52weeks_pricenumber
data.snapshot_list[].highest_history_pricenumber
data.snapshot_list[].lowest_history_pricenumber
data.snapshot_list[].equity_validbool
data.snapshot_list[].issued_sharesint
data.snapshot_list[].total_market_valnumber
data.snapshot_list[].outstanding_sharesint
data.snapshot_list[].circular_market_valnumber
data.snapshot_list[].pe_rationumber
data.snapshot_list[].pe_ttm_rationumber
data.snapshot_list[].pb_rationumber
data.snapshot_list[].dividend_ttmnumber
data.snapshot_list[].dividend_ratio_ttmnumber
data.snapshot_list[].dividend_lfynumber
data.snapshot_list[].dividend_lfy_rationumber
data.snapshot_list[].net_assetnumber
data.snapshot_list[].net_asset_per_sharenumber
data.snapshot_list[].net_profitnumber
data.snapshot_list[].ey_rationumber
data.snapshot_list[].earning_per_sharenumber
data.snapshot_list[].index_raise_countint
data.snapshot_list[].index_fall_countint
data.snapshot_list[].index_equal_countint
data.snapshot_list[].suspensionbool
data.snapshot_list[].avg_pricenumber
data.snapshot_list[].wrt_validbool
data.snapshot_list[].wrt_maturity_dateint
data.snapshot_list[].wrt_end_tradestring
data.snapshot_list[].trust_validbool
data.snapshot_list[].trust_aumnumber
data.snapshot_list[].trust_assetClassstring
data.snapshot_list[].trust_dividend_yieldnumber
data.snapshot_list[].trust_netAssetValuenumber
data.snapshot_list[].trust_outstanding_unitsstring
data.snapshot_list[].trust_premiumnumber
data.snapshot_list[].lot_sizeint
data.snapshot_list[].option_validbool
data.snapshot_list[].option_strike_pricenumber
data.snapshot_list[].option_contract_sizeint
data.snapshot_list[].option_open_interestint
data.snapshot_list[].option_implied_volatilitynumber
data.snapshot_list[].deltanumber
data.snapshot_list[].gammanumber
data.snapshot_list[].veganumber
data.snapshot_list[].thetanumber
data.snapshot_list[].rhonumber
data.snapshot_list[].option_net_open_interestint
data.snapshot_list[].option_contract_nominal_valuenumber
data.snapshot_list[].option_owner_lot_multipliernumber
data.snapshot_list[].option_typestring
data.snapshot_list[].option_contract_multiplierstring
data.snapshot_list[].index_option_typeint
data.snapshot_list[].option_expiry_date_distanceint
data.snapshot_list[].option_area_typestring
data.snapshot_list[].index_validbool
data.snapshot_list[].plate_validbool
data.snapshot_list[].future_validbool
data.snapshot_list[].future_ex_dataobject
data.snapshot_list[].future_ex_data.last_settle_pricenumber
data.snapshot_list[].future_ex_data.positionint
data.snapshot_list[].future_ex_data.position_changeint
data.snapshot_list[].event_contract_ex_dataobject
data.snapshot_list[].event_contract_ex_data.settle_resultint
data.snapshot_list[].event_contract_ex_data.settle_valuenumber
data.snapshot_list[].event_contract_ex_data.settle_timeint
data.snapshot_list[].event_contract_ex_data.open_intereststring
data.snapshot_list[].event_contract_ex_data.liquiditystring
data.snapshot_list[].pre_pricenumber
data.snapshot_list[].pre_high_pricenumber
data.snapshot_list[].pre_low_pricenumber
data.snapshot_list[].pre_volumeint
data.snapshot_list[].pre_turnovernumber
data.snapshot_list[].pre_change_valnumber
data.snapshot_list[].pre_change_ratenumber
data.snapshot_list[].pre_amplitudenumber
data.snapshot_list[].after_pricenumber
data.snapshot_list[].after_high_pricenumber
data.snapshot_list[].after_low_pricenumber
data.snapshot_list[].after_volumeint
data.snapshot_list[].after_turnovernumber
data.snapshot_list[].after_change_valnumber
data.snapshot_list[].after_change_ratenumber
data.snapshot_list[].after_amplitudenumber
data.snapshot_list[].overnight_pricenumber
data.snapshot_list[].overnight_high_pricenumber
data.snapshot_list[].overnight_low_pricenumber
data.snapshot_list[].overnight_volumeint
data.snapshot_list[].overnight_turnovernumber
data.snapshot_list[].overnight_change_valnumber
data.snapshot_list[].overnight_change_ratenumber
data.snapshot_list[].overnight_amplitudenumber
paginationobject部分接口返回分页信息

品类标志位(用于调用方按位筛取专属字段) ​

字段类型说明
equity_validbool是否正股;为 true 时财务字段才有意义。
index_validbool是否指数。
plate_validbool是否板块。
wrt_validbool是否窝轮 / 牛熊证 / 界内证。
trust_validbool是否信托 / 基金 / REIT。
option_validbool是否期权。
future_validbool是否期货。

正股字段(equity_valid=true 时有意义;其它品类为 0) ​

字段类型说明
issued_sharesint64总股本(股)。
total_market_valdouble总市值(货币单位)。
outstanding_sharesint64流通股本(股)。
circular_market_valdouble流通市值(货币单位)。
pe_ratiodouble静态 PE。
pe_ttm_ratiodouble滚动 PE(TTM)。
pb_ratiodouble市净率。
dividend_ttmdoubleTTM 股息(每股)。
dividend_ratio_ttmdoubleTTM 股息率(百分比)。
dividend_lfydouble上一财年股息(每股)。
dividend_lfy_ratiodouble上一财年股息率(百分比)。
net_assetdouble净资产。
net_asset_per_sharedouble每股净资产。
net_profitdouble净利润(上一财年)。
ey_ratiodouble收益率(EY,百分比)。
earning_per_sharedouble每股收益(EPS,上一财年)。

指数字段(index_valid=true) ​

字段类型说明
index_raise_countint64成分股上涨家数。
index_fall_countint64成分股下跌家数。
index_equal_countint64成分股平盘家数。

窝轮 / 牛熊证 / 界内证(wrt_valid=true) ​

字段类型说明
wrt_maturity_dateint64到期日(秒级时间戳)。
wrt_end_tradeint64最后交易日(秒级时间戳)。

信托 / 基金 / REIT(trust_valid=true) ​

字段类型说明
trust_aumdouble资产管理规模(AUM)。
trust_dividend_yielddouble股息率(百分比)。
trust_outstanding_unitsint64流通单位数。
trust_netAssetValuedouble单位净值(NAV)。
trust_premiumdouble溢价(百分比)。
trust_assetClassstring资产类别,详见下方 trust_assetClass 枚举表

枚举 trust_assetClass(信托 / 基金 / REIT 资产类别)

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

期权(option_valid=true) ​

字段类型说明
option_strike_pricedouble行权价。
option_contract_sizeint64合约规模。
option_open_interestint64未平仓量。
option_implied_volatilitydouble隐含波动率(百分比)。
deltadoubleΔ。
gammadoubleΓ。
vegadoubleν。
thetadoubleΘ。
rhodoubleρ。
option_net_open_interestint64净未平仓。
option_contract_nominal_valuedouble合约名义价值。
option_owner_lot_multiplierdouble正股每手乘数。
option_typestring期权方向,详见枚举对照表 option_type
option_contract_multiplierint64合约乘数。
index_option_typeint32指数期权类型。
option_expiry_date_distanceint64距到期日天数(已过期为负数)。
option_area_typestring期权行权类型,详见枚举对照表 option_area_type

期货(future_valid=true) ​

字段类型说明
future_last_settle_pricedouble上一结算价。
future_positionint64持仓。
future_position_changeint64持仓变化。

时段字段(盘前 / 盘后 / 夜盘;非该时段为 0) ​

字段类型说明
pre_price / pre_high_price / pre_low_pricedouble盘前价 / 高 / 低。
pre_volume / pre_turnoverint64 / double盘前成交量 / 额。
pre_change_val / pre_change_ratedouble盘前涨跌额 / 涨跌幅(百分比)。
pre_amplitudedouble盘前振幅(百分比)。
after_price / after_high_price / after_low_pricedouble盘后价 / 高 / 低。
after_volume / after_turnoverint64 / double盘后成交量 / 额(SH 科创板自动并入 kcb 段)。
after_change_val / after_change_ratedouble盘后涨跌额 / 涨跌幅(百分比)。
after_amplitudedouble盘后振幅(百分比)。
overnight_price / overnight_high_price / overnight_low_pricedouble夜盘价 / 高 / 低。
overnight_volume / overnight_turnoverint64 / double夜盘成交量 / 额。
overnight_change_val / overnight_change_ratedouble夜盘涨跌额 / 涨跌幅(百分比)。
overnight_amplitudedouble夜盘振幅(百分比)。

限制范围 ​

  • code 必须使用接口支持且已开通行情权限的市场前缀;下表列出常见市场,其他已注册前缀同样可能受支持,否则返回 invalid_symbol。
  • code_list 全部非法 → invalid_symbol;部分非法 → 仅返回合法部分(对照请求与响应可识别被丢弃的 code)。

常见市场前缀与品类:

前缀市场支持品类
HK香港正股 / 信托 / REIT / 窝轮 / 牛熊证 / 界内证 / 指数 / 板块 / ETF / 期权
US美国正股 / ETF / 指数
SH上海正股 / ETF / 指数 / 板块
SZ深圳正股 / ETF / 指数 / 板块
BJ北京正股 / 指数
KR韩国正股 / ETF / 指数

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功(含部分 code 被识别为非法但仍有合法返回)调用方按 data.snapshot_list[].code 与请求 code_list 比对,识别被丢弃的 code
-3invalid_parameter缺 code_list / 元素数为 0 / 元素数 > 400 / 元素非字符串校正请求体后重试
-4 / -6internal_error服务错误重试;持续失败请联系技术支持
-7invalid_symbolcode_list 全部 code 都无法解析(前缀不支持 / 代码不存在)检查市场前缀是否在限制范围内;通过 search 接口确认代码合法性

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "",
  "data": {
    "snapshot_list": [
      {
        "code": "HK.09988",
        "name": "Alibaba-W",
        "sc_name": "阿里巴巴-W",
        "tc_name": "阿里巴巴-W",
        "update_time": 1780382399000,
        "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,
        "close_price_5min": 128.5,
        "close_price_15min": 128.2,
        "close_price_5day": 126.8,
        "close_price_10day": 125.4,
        "close_price_20day": 123.1,
        "close_price_60day": 118.5,
        "close_price_120day": 112.8,
        "close_price_250day": 105.6,
        "close_price_month": 127.3,
        "close_price_year": 106.2,
        "close_price_3year": 90.4,
        "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.25,
        "listing_date": 1574697600000,
        "lot_size": 100,
        "sec_status": "NORMAL",
        "dark_status": "N/A",
        "option_type": "",
        "option_area_type": ""
      },
      {
        "code": "BMD.FCPOmain",
        "name": "Palm Oil Main",
        "sc_name": "棕榈油主连",
        "tc_name": "棕櫚油主連",
        "update_time": 1780382399000,
        "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": "Tencent 260629 390.00 Call",
        "sc_name": "腾讯控股 260629 390.00 购",
        "tc_name": "騰訊控股 260629 390.00 購",
        "update_time": 1780382399000,
        "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"
      }
    ]
  }
}