Market Snapshot
POST/api/v1.0/quote/snapshotBatch 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
| Name | Type | In | Required | Description |
|---|---|---|---|---|
code_list | string[] | body | yes | List of symbol codes (min 1, max 400). Format: <MARKET>.<CODE>, e.g. HK.09988, US.AAPL, BMD.FCPOmain. |
Request Example
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"]}' | jqResponse 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)
| Name | Type | Description |
|---|---|---|
data | object | |
data.snapshot_list | object[] | |
data.snapshot_list[].code | string | |
data.snapshot_list[].name | string | |
data.snapshot_list[].sc_name | string | |
data.snapshot_list[].tc_name | string | |
data.snapshot_list[].update_time | int | |
data.snapshot_list[].data_date | string | |
data.snapshot_list[].last_price | number | |
data.snapshot_list[].open_price | number | |
data.snapshot_list[].high_price | number | |
data.snapshot_list[].low_price | number | |
data.snapshot_list[].prev_close_price | number | |
data.snapshot_list[].close_price_5min | number | 5-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_15min | number | 15-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_5day | number | 5-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_10day | number | 10-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_20day | number | 20-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_60day | number | 60-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_120day | number | 120-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_250day | number | 250-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_month | number | 1-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_year | number | 1-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_3year | number | 3-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[].volume | int | |
data.snapshot_list[].turnover | number | |
data.snapshot_list[].turnover_rate | number | |
data.snapshot_list[].amplitude | number | |
data.snapshot_list[].volume_ratio | number | |
data.snapshot_list[].bid_ask_ratio | number | |
data.snapshot_list[].sec_status | string | |
data.snapshot_list[].dark_status | string | |
data.snapshot_list[].listing_date | int | |
data.snapshot_list[].bid_price | number | |
data.snapshot_list[].ask_price | number | |
data.snapshot_list[].bid_vol | int | |
data.snapshot_list[].ask_vol | int | |
data.snapshot_list[].price_spread | number | |
data.snapshot_list[].highest52weeks_price | number | |
data.snapshot_list[].lowest52weeks_price | number | |
data.snapshot_list[].highest_history_price | number | |
data.snapshot_list[].lowest_history_price | number | |
data.snapshot_list[].equity_valid | bool | |
data.snapshot_list[].issued_shares | int | |
data.snapshot_list[].total_market_val | number | |
data.snapshot_list[].outstanding_shares | int | |
data.snapshot_list[].circular_market_val | number | |
data.snapshot_list[].pe_ratio | number | |
data.snapshot_list[].pe_ttm_ratio | number | |
data.snapshot_list[].pb_ratio | number | |
data.snapshot_list[].dividend_ttm | number | |
data.snapshot_list[].dividend_ratio_ttm | number | |
data.snapshot_list[].dividend_lfy | number | |
data.snapshot_list[].dividend_lfy_ratio | number | |
data.snapshot_list[].net_asset | number | |
data.snapshot_list[].net_asset_per_share | number | |
data.snapshot_list[].net_profit | number | |
data.snapshot_list[].ey_ratio | number | |
data.snapshot_list[].earning_per_share | number | |
data.snapshot_list[].index_raise_count | int | |
data.snapshot_list[].index_fall_count | int | |
data.snapshot_list[].index_equal_count | int | |
data.snapshot_list[].suspension | bool | |
data.snapshot_list[].avg_price | number | |
data.snapshot_list[].wrt_valid | bool | |
data.snapshot_list[].wrt_maturity_date | int | |
data.snapshot_list[].wrt_end_trade | string | |
data.snapshot_list[].trust_valid | bool | |
data.snapshot_list[].trust_aum | number | |
data.snapshot_list[].trust_assetClass | string | |
data.snapshot_list[].trust_dividend_yield | number | |
data.snapshot_list[].trust_netAssetValue | number | |
data.snapshot_list[].trust_outstanding_units | string | |
data.snapshot_list[].trust_premium | number | |
data.snapshot_list[].lot_size | int | |
data.snapshot_list[].option_valid | bool | |
data.snapshot_list[].option_strike_price | number | |
data.snapshot_list[].option_contract_size | int | |
data.snapshot_list[].option_open_interest | int | |
data.snapshot_list[].option_implied_volatility | number | |
data.snapshot_list[].delta | number | |
data.snapshot_list[].gamma | number | |
data.snapshot_list[].vega | number | |
data.snapshot_list[].theta | number | |
data.snapshot_list[].rho | number | |
data.snapshot_list[].option_net_open_interest | int | |
data.snapshot_list[].option_contract_nominal_value | number | |
data.snapshot_list[].option_owner_lot_multiplier | number | |
data.snapshot_list[].option_type | string | |
data.snapshot_list[].option_contract_multiplier | string | |
data.snapshot_list[].index_option_type | int | |
data.snapshot_list[].option_expiry_date_distance | int | |
data.snapshot_list[].option_area_type | string | |
data.snapshot_list[].index_valid | bool | |
data.snapshot_list[].plate_valid | bool | |
data.snapshot_list[].future_valid | bool | |
data.snapshot_list[].future_ex_data | object | |
data.snapshot_list[].future_ex_data.last_settle_price | number | |
data.snapshot_list[].future_ex_data.position | int | |
data.snapshot_list[].future_ex_data.position_change | int | |
data.snapshot_list[].event_contract_ex_data | object | |
data.snapshot_list[].event_contract_ex_data.settle_result | int | |
data.snapshot_list[].event_contract_ex_data.settle_value | number | |
data.snapshot_list[].event_contract_ex_data.settle_time | int | |
data.snapshot_list[].event_contract_ex_data.open_interest | string | |
data.snapshot_list[].event_contract_ex_data.liquidity | string | |
data.snapshot_list[].pre_price | number | |
data.snapshot_list[].pre_high_price | number | |
data.snapshot_list[].pre_low_price | number | |
data.snapshot_list[].pre_volume | int | |
data.snapshot_list[].pre_turnover | number | |
data.snapshot_list[].pre_change_val | number | |
data.snapshot_list[].pre_change_rate | number | |
data.snapshot_list[].pre_amplitude | number | |
data.snapshot_list[].after_price | number | |
data.snapshot_list[].after_high_price | number | |
data.snapshot_list[].after_low_price | number | |
data.snapshot_list[].after_volume | int | |
data.snapshot_list[].after_turnover | number | |
data.snapshot_list[].after_change_val | number | |
data.snapshot_list[].after_change_rate | number | |
data.snapshot_list[].after_amplitude | number | |
data.snapshot_list[].overnight_price | number | |
data.snapshot_list[].overnight_high_price | number | |
data.snapshot_list[].overnight_low_price | number | |
data.snapshot_list[].overnight_volume | int | |
data.snapshot_list[].overnight_turnover | number | |
data.snapshot_list[].overnight_change_val | number | |
data.snapshot_list[].overnight_change_rate | number | |
data.snapshot_list[].overnight_amplitude | number | |
pagination | object | Pagination returned by some endpoints |
Category Flags (for filtering category-specific fields)
| Field | Type | Description |
|---|---|---|
| equity_valid | bool | Whether equity; financial fields are meaningful only when true. |
| index_valid | bool | Whether index. |
| plate_valid | bool | Whether sector/plate. |
| wrt_valid | bool | Whether warrant / CBBC / inline warrant. |
| trust_valid | bool | Whether trust / fund / REIT. |
| option_valid | bool | Whether option. |
| future_valid | bool | Whether futures. |
Equity Fields (meaningful when equity_valid=true; 0 for other categories)
| Field | Type | Description |
|---|---|---|
| issued_shares | int64 | Total shares outstanding. |
| total_market_val | double | Total market capitalization (currency unit). |
| outstanding_shares | int64 | Float shares. |
| circular_market_val | double | Float market capitalization (currency unit). |
| pe_ratio | double | Static PE. |
| pe_ttm_ratio | double | Trailing PE (TTM). |
| pb_ratio | double | Price-to-book ratio. |
| dividend_ttm | double | TTM dividend (per share). |
| dividend_ratio_ttm | double | TTM dividend yield (percentage). |
| dividend_lfy | double | Last fiscal year dividend (per share). |
| dividend_lfy_ratio | double | Last fiscal year dividend yield (percentage). |
| net_asset | double | Net assets. |
| net_asset_per_share | double | Net asset per share. |
| net_profit | double | Net profit (last fiscal year). |
| ey_ratio | double | Earnings yield (EY, percentage). |
| earning_per_share | double | Earnings per share (EPS, last fiscal year). |
Index Fields (index_valid=true)
| Field | Type | Description |
|---|---|---|
| index_raise_count | int64 | Number of rising constituents. |
| index_fall_count | int64 | Number of falling constituents. |
| index_equal_count | int64 | Number of flat constituents. |
Warrant / CBBC / Inline Warrant (wrt_valid=true)
| Field | Type | Description |
|---|---|---|
| wrt_maturity_date | int64 | Maturity date (second-level timestamp). |
| wrt_end_trade | int64 | Last trading date (second-level timestamp). |
Trust / Fund / REIT (trust_valid=true)
| Field | Type | Description |
|---|---|---|
| trust_aum | double | Assets under management (AUM). |
| trust_dividend_yield | double | Dividend yield (percentage). |
| trust_outstanding_units | int64 | Outstanding units. |
| trust_netAssetValue | double | Net asset value per unit (NAV). |
| trust_premium | double | Premium (percentage). |
| trust_assetClass | string | Asset class, see trust_assetClass enum below |
Enum trust_assetClass (Trust / Fund / REIT asset class)
| Value | Meaning |
|---|---|
| STOCK | Stock |
| BOND | Bond |
| COMMODITY | Commodity |
| CURRENCY_MARKET | Currency Market |
| FUTURE | Futures |
| SWAP | Swap |
Option (option_valid=true)
| Field | Type | Description |
|---|---|---|
| option_strike_price | double | Strike price. |
| option_contract_size | int64 | Contract size. |
| option_open_interest | int64 | Open interest. |
| option_implied_volatility | double | Implied volatility (percentage). |
| delta | double | Delta. |
| gamma | double | Gamma. |
| vega | double | Vega. |
| theta | double | Theta. |
| rho | double | Rho. |
| option_net_open_interest | int64 | Net open interest. |
| option_contract_nominal_value | double | Contract nominal value. |
| option_owner_lot_multiplier | double | Underlying lot multiplier. |
| option_type | string | Option direction, see enum option_type |
| option_contract_multiplier | int64 | Contract multiplier. |
| index_option_type | int32 | Index option type. |
| option_expiry_date_distance | int64 | Days to expiry (negative if expired). |
| option_area_type | string | Option exercise type, see enum option_area_type |
Futures (future_valid=true)
| Field | Type | Description |
|---|---|---|
| future_last_settle_price | double | Previous settlement price. |
| future_position | int64 | Open interest (position). |
| future_position_change | int64 | Position change. |
Session Fields (pre-market / after-hours / overnight; 0 when not in that session)
| Field | Type | Description |
|---|---|---|
| pre_price / pre_high_price / pre_low_price | double | Pre-market price / high / low. |
| pre_volume / pre_turnover | int64 / double | Pre-market volume / turnover. |
| pre_change_val / pre_change_rate | double | Pre-market change value / change rate (percentage). |
| pre_amplitude | double | Pre-market amplitude (percentage). |
| after_price / after_high_price / after_low_price | double | After-hours price / high / low. |
| after_volume / after_turnover | int64 / double | After-hours volume / turnover (SH STAR Market auto-merged into kcb segment). |
| after_change_val / after_change_rate | double | After-hours change value / change rate (percentage). |
| after_amplitude | double | After-hours amplitude (percentage). |
| overnight_price / overnight_high_price / overnight_low_price | double | Overnight price / high / low. |
| overnight_volume / overnight_turnover | int64 / double | Overnight volume / turnover. |
| overnight_change_val / overnight_change_rate | double | Overnight change value / change rate (percentage). |
| overnight_amplitude | double | Overnight 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:
| Prefix | Market | Supported Categories |
|---|---|---|
| HK | Hong Kong | Equity / Trust / REIT / Warrant / CBBC / Inline Warrant / Index / Sector / ETF / Option |
| US | United States | Equity / ETF / Index |
| SH | Shanghai | Equity / ETF / Index / Sector |
| SZ | Shenzhen | Equity / ETF / Index / Sector |
| BJ | Beijing | Equity / Index |
| KR | Korea | Equity / ETF / Index |
Error Codes
| ret_code | error.code | Trigger Condition | Recommended 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 |
| -3 | invalid_parameter | Missing code_list / element count is 0 / element count > 400 / elements are not strings | Correct request body and retry |
| -4 / -6 | internal_error | Service error | Retry; if persistent, contact support |
| -7 | invalid_symbol | All 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
{
"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"
}
]
}
}