Stock Quote
POST/api/v1.0/quote/stock-quoteBatch 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
| Parameter | Type | Position | Required | Description |
|---|---|---|---|---|
code_list | string[] | body | yes | List 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"]}' | jqResponse 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)
| Name | Type | Description |
|---|---|---|
data | object | |
data.quote_list | object[] | |
data.quote_list[].code | string | |
data.quote_list[].name | string | |
data.quote_list[].sc_name | string | |
data.quote_list[].tc_name | string | |
data.quote_list[].data_time | int | |
data.quote_list[].data_date | string | |
data.quote_list[].last_price | number | |
data.quote_list[].open_price | number | |
data.quote_list[].high_price | number | |
data.quote_list[].low_price | number | |
data.quote_list[].prev_close_price | number | |
data.quote_list[].volume | int | |
data.quote_list[].turnover | number | |
data.quote_list[].turnover_rate | number | |
data.quote_list[].amplitude | number | |
data.quote_list[].sec_status | string | |
data.quote_list[].suspension | bool | |
data.quote_list[].dark_status | string | |
data.quote_list[].listing_date | string | |
data.quote_list[].option_ex_data | object | |
data.quote_list[].option_ex_data.strike_price | number | |
data.quote_list[].option_ex_data.contract_size | int | |
data.quote_list[].option_ex_data.open_interest | int | |
data.quote_list[].option_ex_data.implied_volatility | number | |
data.quote_list[].option_ex_data.premium | number | |
data.quote_list[].option_ex_data.delta | number | |
data.quote_list[].option_ex_data.gamma | number | |
data.quote_list[].option_ex_data.vega | number | |
data.quote_list[].option_ex_data.theta | number | |
data.quote_list[].option_ex_data.rho | number | |
data.quote_list[].option_ex_data.net_open_interest | int | |
data.quote_list[].option_ex_data.contract_nominal_value | number | |
data.quote_list[].option_ex_data.owner_lot_multiplier | int | |
data.quote_list[].option_ex_data.contract_multiplier | int | |
data.quote_list[].option_ex_data.option_type | string | |
data.quote_list[].option_ex_data.index_option_type | int | |
data.quote_list[].option_ex_data.expiry_date_distance | int | |
data.quote_list[].option_ex_data.option_area_type | string | |
data.quote_list[].future_ex_data | object | |
data.quote_list[].future_ex_data.last_settle_price | number | |
data.quote_list[].future_ex_data.position | int | |
data.quote_list[].future_ex_data.position_change | int | |
data.quote_list[].event_contract_ex_data | object | |
data.quote_list[].event_contract_ex_data.settle_result | int | |
data.quote_list[].event_contract_ex_data.settle_value | number | |
data.quote_list[].event_contract_ex_data.settle_time | int | |
data.quote_list[].event_contract_ex_data.open_interest | string | |
data.quote_list[].event_contract_ex_data.liquidity | string | |
data.quote_list[].pre_market | object | |
data.quote_list[].pre_market.price | number | |
data.quote_list[].pre_market.high_price | number | |
data.quote_list[].pre_market.low_price | number | |
data.quote_list[].pre_market.volume | int | |
data.quote_list[].pre_market.turnover | number | |
data.quote_list[].pre_market.change_val | number | |
data.quote_list[].pre_market.change_rate | number | |
data.quote_list[].pre_market.amplitude | number | |
data.quote_list[].after_market | object | |
data.quote_list[].after_market.price | number | |
data.quote_list[].after_market.high_price | number | |
data.quote_list[].after_market.low_price | number | |
data.quote_list[].after_market.volume | int | |
data.quote_list[].after_market.turnover | number | |
data.quote_list[].after_market.change_val | number | |
data.quote_list[].after_market.change_rate | number | |
data.quote_list[].after_market.amplitude | number | |
data.quote_list[].overnight | object | |
data.quote_list[].overnight.price | number | |
data.quote_list[].overnight.high_price | number | |
data.quote_list[].overnight.low_price | number | |
data.quote_list[].overnight.volume | int | |
data.quote_list[].overnight.turnover | number | |
data.quote_list[].overnight.change_val | number | |
data.quote_list[].overnight.change_rate | number | |
data.quote_list[].overnight.amplitude | number | |
pagination | object | Pagination returned by some endpoints |
option_ex_data Sub-object (only meaningful for options; all fields are 0 or empty string for other categories)
| Field | Type | Description |
|---|---|---|
| strike_price | double | Strike price. |
| contract_size | int64 | Contract size. |
| open_interest | int64 | Open interest. |
| implied_volatility | double | Implied volatility (percentage). |
| premium | double | Option premium. |
| delta | double | Delta. |
| gamma | double | Gamma. |
| vega | double | Vega. |
| theta | double | Theta. |
| rho | double | Rho. |
| net_open_interest | int64 | Net open interest. |
| contract_nominal_value | double | Contract nominal value. |
| owner_lot_multiplier | int64 | Underlying lot multiplier. |
| contract_multiplier | int64 | Contract multiplier. |
| option_type | string | Option direction, see enum option_type |
| index_option_type | int32 | Index option type. |
| expiry_date_distance | int64 | Days to expiry (negative if expired). |
| option_area_type | string | Option exercise type, see enum option_area_type |
future_ex_data Sub-object (only meaningful for futures; all fields are 0 for other categories)
| Field | Type | Description |
|---|---|---|
| last_settle_price | double | Previous settlement price. |
| position | int64 | Open interest (position). |
| position_change | int64 | Position change. |
pre_market / after_market / overnight Sub-objects (0 when not in that session)
| Field | Type | Description |
|---|---|---|
| price | double | Session price. |
| high_price | double | Session high. |
| low_price | double | Session low. |
| volume | int64 | Session volume. |
| turnover | double | Session turnover. |
| change_val | double | Change value. |
| change_rate | double | Change rate (percentage). |
| amplitude | double | Amplitude (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:
| 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.quote_list[].code with request code_list to identify dropped codes |
| -3 | invalid_parameter | Missing code_list / element count is 0 / element count exceeds 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
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
}
}
]
}
}