Plate Stock
GET/api/v1.0/quote/plate-stockGet the list of stock members under a specified plate (sector), with sorting and pagination support.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
plate_code | string | query | yes | Plate code (from quote.plate_list), e.g. HK.LIST1045 Max length 32; Pattern ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$ |
sort_field | string | query | no | Sort field. Default NONE. See Naming Dictionary. Default "NONE" |
ascend | bool | query | no | Whether to sort in ascending order, default true. e.g. true=ascending / false=descending Default true |
price_type | string | query | no | Price scope for price-related sorting: NORMAL / BEFORE / AFTER / OVERNIGHT. Default NORMAL Default "NORMAL"; Values NORMAL, BEFORE, AFTER, OVERNIGHT |
leverage_direction | int | query | no | ETF leverage direction filter (ETF plates only): 0=all / 1=long / 2=short. Default 0 ≥ 0; ≤ 2; Default 0 |
leverage_multiple | int | query | no | ETF leverage multiple filter (ETF plates only), scaled by 10^3, e.g. 2000=2x / 1500=1.5x / 0=all. Default 0 ≥ 0; Default 0 |
next_key | string | query | no | Pagination cursor (empty for first page). Pass back pagination.next_key; stop when pagination.has_more=false Max length 1000; Pattern ^$|^(-?[0-9]+)?$ |
limit | int | query | no | Page size, default 200, max 1000 ≤ 1000; Default 200 |
Request Example
bash
curl 'https://webapi.futunn.com/api/v1.0/quote/plate-stock?plate_code=HK.LIST1045&limit=2' | jqResponse Fields
Returns data.stock_list[] as the plate constituent stock list; pagination info in top-level pagination.
| Name | Type | Description |
|---|---|---|
data | object | |
data.stock_list | object[] | |
data.stock_list[].code | string | Stock symbol with market prefix, e.g. HK.02337 |
data.stock_list[].lot_size | int | Lot size (option=contract shares, futures=contract multiplier), e.g. 1000 |
data.stock_list[].stock_name | string | English name |
data.stock_list[].sc_name | string | Simplified Chinese name |
data.stock_list[].tc_name | string | Traditional Chinese name |
data.stock_list[].stock_type | string | Security type, e.g. STOCK / ETF / WARRANT / FUTURE / DRVT, etc. |
data.stock_list[].list_time | int | Listing time, millisecond timestamp; 0 if missing, e.g. 1508083200000 |
data.stock_list[].stock_id | int | Stock ID (numeric identifier), e.g. 74891344742689 |
pagination | object | |
pagination.total | int | |
pagination.has_more | bool | |
pagination.next_key | string |
Supported Markets
- Markets: HK / US / SH / SZ / SG / JP / CA / AU / MY / KR and all markets (consistent with plates returned by the plate list API).
- ETF leverage filters (
leverage_direction/leverage_multiple) only take effect for ETF plates; they are ignored for other plates even if passed. price_typeonly affects the value source for price-type sort fields.
Error Codes
| ret_code | error.code | Trigger Condition | Handling |
|---|---|---|---|
| 0 | -- | Success (valid plate with no constituents returns empty stock_list with pagination.total=0) | -- |
| -3 | invalid_parameter | Missing plate_code / plate_code doesn't match market prefix regex / sort_field not in enum / price_type not in enum / limit exceeds 1000 / invalid next_key | Correct request parameters and retry |
| -7 | invalid_symbol | plate_code cannot resolve to a valid plate (code does not exist or has been delisted) | Get valid plate codes from the plate list API |
| -4 | internal_error | Service error | Retry; contact support if persistent |
Response Example
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"stock_list": [
{
"code": "HK.02337",
"stock_id": 74891344742689,
"stock_name": "众诚能源",
"stock_type": "STOCK",
"lot_size": 1000,
"list_time": 1508083200000
},
{
"code": "HK.01193",
"stock_id": 38976828212393,
"stock_name": "华润燃气",
"stock_type": "STOCK",
"lot_size": 100,
"list_time": 784137600000
}
]
},
"pagination": {
"has_more": true,
"next_key": "2",
"total": 22
}
}