Skip to content

Market Snapshot ​

POST /api/v1.0/quote/snapshot

Batch get real-time market snapshot for up to 400 symbols. Returns common fields (last/open/high/low/prev close, volume, turnover, turnover rate, etc.), financial fields (market cap, PE, PB, EPS, dividend yield, etc.) and category-specific fields (index component counts, futures settlement, options greeks, etc.).

Parameters ​

NameTypeInRequiredDescription
code_liststring[]bodyyesList of symbol codes (min 1, max 400). Format: <MARKET>.<CODE>, e.g. HK.09988, US.AAPL, BMD.FCPOmain.

Request Example ​

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

Response Fields ​

Returns data.snapshot_list[], each element is one symbol snapshot. Fields are grouped by category (fields not applicable to a category will be default/0/empty string).

Historical closing prices (close_price_*) use the same units as last_price and are included in snapshots without a new subscription type. When historical data is unavailable, a field may be omitted or returned as 0; 0 does not indicate an actual closing price.

Common Fields (returned for all categories) ​

NameTypeDescription
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-minute closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_15minnumber15-minute closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_5daynumber5-day closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_10daynumber10-day closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_20daynumber20-day closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_60daynumber60-day closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_120daynumber120-day closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_250daynumber250-day closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_monthnumber1-month closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_yearnumber1-year closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
data.snapshot_list[].close_price_3yearnumber3-year closing price, in the same units as last_price; may be omitted or 0 when unavailable; 0 does not indicate an actual closing price.
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
paginationobjectPagination returned by some endpoints

Category Flags (for filtering category-specific fields) ​

FieldTypeDescription
equity_validboolWhether equity; financial fields are meaningful only when true.
index_validboolWhether index.
plate_validboolWhether sector/plate.
wrt_validboolWhether warrant / CBBC / inline warrant.
trust_validboolWhether trust / fund / REIT.
option_validboolWhether option.
future_validboolWhether futures.

Equity Fields (meaningful when equity_valid=true; 0 for other categories) ​

FieldTypeDescription
issued_sharesint64Total shares outstanding.
total_market_valdoubleTotal market capitalization (currency unit).
outstanding_sharesint64Float shares.
circular_market_valdoubleFloat market capitalization (currency unit).
pe_ratiodoubleStatic PE.
pe_ttm_ratiodoubleTrailing PE (TTM).
pb_ratiodoublePrice-to-book ratio.
dividend_ttmdoubleTTM dividend (per share).
dividend_ratio_ttmdoubleTTM dividend yield (percentage).
dividend_lfydoubleLast fiscal year dividend (per share).
dividend_lfy_ratiodoubleLast fiscal year dividend yield (percentage).
net_assetdoubleNet assets.
net_asset_per_sharedoubleNet asset per share.
net_profitdoubleNet profit (last fiscal year).
ey_ratiodoubleEarnings yield (EY, percentage).
earning_per_sharedoubleEarnings per share (EPS, last fiscal year).

Index Fields (index_valid=true) ​

FieldTypeDescription
index_raise_countint64Number of rising constituents.
index_fall_countint64Number of falling constituents.
index_equal_countint64Number of flat constituents.

Warrant / CBBC / Inline Warrant (wrt_valid=true) ​

FieldTypeDescription
wrt_maturity_dateint64Maturity date (second-level timestamp).
wrt_end_tradeint64Last trading date (second-level timestamp).

Trust / Fund / REIT (trust_valid=true) ​

FieldTypeDescription
trust_aumdoubleAssets under management (AUM).
trust_dividend_yielddoubleDividend yield (percentage).
trust_outstanding_unitsint64Outstanding units.
trust_netAssetValuedoubleNet asset value per unit (NAV).
trust_premiumdoublePremium (percentage).
trust_assetClassstringAsset class, see trust_assetClass enum below

Enum trust_assetClass (Trust / Fund / REIT asset class)

ValueMeaning
STOCKStock
BONDBond
COMMODITYCommodity
CURRENCY_MARKETCurrency Market
FUTUREFutures
SWAPSwap

Option (option_valid=true) ​

FieldTypeDescription
option_strike_pricedoubleStrike price.
option_contract_sizeint64Contract size.
option_open_interestint64Open interest.
option_implied_volatilitydoubleImplied volatility (percentage).
deltadoubleDelta.
gammadoubleGamma.
vegadoubleVega.
thetadoubleTheta.
rhodoubleRho.
option_net_open_interestint64Net open interest.
option_contract_nominal_valuedoubleContract nominal value.
option_owner_lot_multiplierdoubleUnderlying lot multiplier.
option_typestringOption direction, see enum option_type
option_contract_multiplierint64Contract multiplier.
index_option_typeint32Index option type.
option_expiry_date_distanceint64Days to expiry (negative if expired).
option_area_typestringOption exercise type, see enum option_area_type

Futures (future_valid=true) ​

FieldTypeDescription
future_last_settle_pricedoublePrevious settlement price.
future_positionint64Open interest (position).
future_position_changeint64Position change.

Session Fields (pre-market / after-hours / overnight; 0 when not in that session) ​

FieldTypeDescription
pre_price / pre_high_price / pre_low_pricedoublePre-market price / high / low.
pre_volume / pre_turnoverint64 / doublePre-market volume / turnover.
pre_change_val / pre_change_ratedoublePre-market change value / change rate (percentage).
pre_amplitudedoublePre-market amplitude (percentage).
after_price / after_high_price / after_low_pricedoubleAfter-hours price / high / low.
after_volume / after_turnoverint64 / doubleAfter-hours volume / turnover (SH STAR Market auto-merged into kcb segment).
after_change_val / after_change_ratedoubleAfter-hours change value / change rate (percentage).
after_amplitudedoubleAfter-hours amplitude (percentage).
overnight_price / overnight_high_price / overnight_low_pricedoubleOvernight price / high / low.
overnight_volume / overnight_turnoverint64 / doubleOvernight volume / turnover.
overnight_change_val / overnight_change_ratedoubleOvernight change value / change rate (percentage).
overnight_amplitudedoubleOvernight amplitude (percentage).

Supported Markets ​

  • Code must use a market prefix supported by the API and your quote entitlements; the table below lists common markets, and other registered prefixes may also be supported. Otherwise, the API returns invalid_symbol.
  • If all codes in code_list are invalid -> invalid_symbol; if partially invalid -> only valid codes are returned (compare request and response to identify dropped codes).

Common market prefixes and categories:

PrefixMarketSupported Categories
HKHong KongEquity / Trust / REIT / Warrant / CBBC / Inline Warrant / Index / Sector / ETF / Option
USUnited StatesEquity / ETF / Index
SHShanghaiEquity / ETF / Index / Sector
SZShenzhenEquity / ETF / Index / Sector
BJBeijingEquity / Index
KRKoreaEquity / ETF / Index

Error Codes ​

ret_codeerror.codeTrigger ConditionRecommended Action
0—Success (including cases where some codes are invalid but valid ones are returned)Compare data.snapshot_list[].code with request code_list to identify dropped codes
-3invalid_parameterMissing code_list / element count is 0 / element count > 400 / elements are not stringsCorrect request body and retry
-4 / -6internal_errorService errorRetry; if persistent, contact support
-7invalid_symbolAll codes in code_list cannot be parsed (unsupported prefix / code does not exist)Check that market prefix is within supported range; use search API to confirm code validity

Response Example ​

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"
      }
    ]
  }
}