Skip to content

Stock Quote ​

POST /api/v1.0/quote/stock-quote

Batch get real-time stock quotes (lightweight snapshot), aligned with the Quote base quote pushed via subscription. Compared to get_market_snapshot, the field set is more compact and suitable for multi-symbol polling.

Request Parameters ​

ParameterTypePositionRequiredDescription
code_liststring[]bodyyesList of symbol codes; at least 1 and at most 400 per request.

Request Example ​

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

Response Fields ​

Returns data.quote_list[], each element is one symbol quote. Fields not applicable to a category are returned as 0 / empty string; sub-object field sets are stable.

Common Fields (returned for all categories) ​

NameTypeDescription
dataobject
data.quote_listobject[]
data.quote_list[].codestring
data.quote_list[].namestring
data.quote_list[].sc_namestring
data.quote_list[].tc_namestring
data.quote_list[].data_timeint
data.quote_list[].data_datestring
data.quote_list[].last_pricenumber
data.quote_list[].open_pricenumber
data.quote_list[].high_pricenumber
data.quote_list[].low_pricenumber
data.quote_list[].prev_close_pricenumber
data.quote_list[].volumeint
data.quote_list[].turnovernumber
data.quote_list[].turnover_ratenumber
data.quote_list[].amplitudenumber
data.quote_list[].sec_statusstring
data.quote_list[].suspensionbool
data.quote_list[].dark_statusstring
data.quote_list[].listing_datestring
data.quote_list[].option_ex_dataobject
data.quote_list[].option_ex_data.strike_pricenumber
data.quote_list[].option_ex_data.contract_sizeint
data.quote_list[].option_ex_data.open_interestint
data.quote_list[].option_ex_data.implied_volatilitynumber
data.quote_list[].option_ex_data.premiumnumber
data.quote_list[].option_ex_data.deltanumber
data.quote_list[].option_ex_data.gammanumber
data.quote_list[].option_ex_data.veganumber
data.quote_list[].option_ex_data.thetanumber
data.quote_list[].option_ex_data.rhonumber
data.quote_list[].option_ex_data.net_open_interestint
data.quote_list[].option_ex_data.contract_nominal_valuenumber
data.quote_list[].option_ex_data.owner_lot_multiplierint
data.quote_list[].option_ex_data.contract_multiplierint
data.quote_list[].option_ex_data.option_typestring
data.quote_list[].option_ex_data.index_option_typeint
data.quote_list[].option_ex_data.expiry_date_distanceint
data.quote_list[].option_ex_data.option_area_typestring
data.quote_list[].future_ex_dataobject
data.quote_list[].future_ex_data.last_settle_pricenumber
data.quote_list[].future_ex_data.positionint
data.quote_list[].future_ex_data.position_changeint
data.quote_list[].event_contract_ex_dataobject
data.quote_list[].event_contract_ex_data.settle_resultint
data.quote_list[].event_contract_ex_data.settle_valuenumber
data.quote_list[].event_contract_ex_data.settle_timeint
data.quote_list[].event_contract_ex_data.open_intereststring
data.quote_list[].event_contract_ex_data.liquiditystring
data.quote_list[].pre_marketobject
data.quote_list[].pre_market.pricenumber
data.quote_list[].pre_market.high_pricenumber
data.quote_list[].pre_market.low_pricenumber
data.quote_list[].pre_market.volumeint
data.quote_list[].pre_market.turnovernumber
data.quote_list[].pre_market.change_valnumber
data.quote_list[].pre_market.change_ratenumber
data.quote_list[].pre_market.amplitudenumber
data.quote_list[].after_marketobject
data.quote_list[].after_market.pricenumber
data.quote_list[].after_market.high_pricenumber
data.quote_list[].after_market.low_pricenumber
data.quote_list[].after_market.volumeint
data.quote_list[].after_market.turnovernumber
data.quote_list[].after_market.change_valnumber
data.quote_list[].after_market.change_ratenumber
data.quote_list[].after_market.amplitudenumber
data.quote_list[].overnightobject
data.quote_list[].overnight.pricenumber
data.quote_list[].overnight.high_pricenumber
data.quote_list[].overnight.low_pricenumber
data.quote_list[].overnight.volumeint
data.quote_list[].overnight.turnovernumber
data.quote_list[].overnight.change_valnumber
data.quote_list[].overnight.change_ratenumber
data.quote_list[].overnight.amplitudenumber
paginationobjectPagination returned by some endpoints

option_ex_data Sub-object (only meaningful for options; all fields are 0 or empty string for other categories) ​

FieldTypeDescription
strike_pricedoubleStrike price.
contract_sizeint64Contract size.
open_interestint64Open interest.
implied_volatilitydoubleImplied volatility (percentage).
premiumdoubleOption premium.
deltadoubleDelta.
gammadoubleGamma.
vegadoubleVega.
thetadoubleTheta.
rhodoubleRho.
net_open_interestint64Net open interest.
contract_nominal_valuedoubleContract nominal value.
owner_lot_multiplierint64Underlying lot multiplier.
contract_multiplierint64Contract multiplier.
option_typestringOption direction, see enum option_type
index_option_typeint32Index option type.
expiry_date_distanceint64Days to expiry (negative if expired).
option_area_typestringOption exercise type, see enum option_area_type

future_ex_data Sub-object (only meaningful for futures; all fields are 0 for other categories) ​

FieldTypeDescription
last_settle_pricedoublePrevious settlement price.
positionint64Open interest (position).
position_changeint64Position change.

pre_market / after_market / overnight Sub-objects (0 when not in that session) ​

FieldTypeDescription
pricedoubleSession price.
high_pricedoubleSession high.
low_pricedoubleSession low.
volumeint64Session volume.
turnoverdoubleSession turnover.
change_valdoubleChange value.
change_ratedoubleChange rate (percentage).
amplitudedoubleAmplitude (percentage).

Note: SH STAR Market's after_market.volume / after_market.turnover are auto-merged into the STAR Market after-hours segment (kcb).

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.quote_list[].code with request code_list to identify dropped codes
-3invalid_parameterMissing code_list / element count is 0 / element count exceeds 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": "success",
  "data": {
    "quote_list": [
      {
        "code": "HK.09988",
        "name": "Alibaba-W",
        "sc_name": "阿里巴巴-W",
        "tc_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": "FCPO Main (2608)",
        "sc_name": "原棕榈油期货主连 (2608)",
        "tc_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": "Tencent 260629 390.00 Call",
        "sc_name": "腾讯 260629 390.00 购",
        "tc_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
        }
      }
    ]
  }
}