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 the plate list API), e.g. HK.LIST1045. |
sort_field | string | query | no | Sort field. Default NONE. See Naming Dictionary. |
ascend | bool | query | no | Ascending order. Default true. |
price_type | string | query | no | Value source for price-type sort fields. Default NORMAL. Values: NORMAL / BEFORE / AFTER / OVERNIGHT. |
leverage_direction | int | query | no | ETF leverage direction filter (only effective for ETF plates): 0=all / 1=long / 2=short. Default 0. |
leverage_multiple | int | query | no | ETF leverage multiple filter (only effective for ETF plates), scaled by 10^3, e.g. 2000=2x. Default 0=all. |
next_key | string | query | no | Pagination cursor. Leave empty for the first page; pass the previous page's pagination.next_key. |
limit | int | query | no | Page size. Default 200, max 1000. |
Request Example
bash
curl 'https://webapi.moomoo.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.
| Field | Type | Description |
|---|---|---|
code | string | Stock code (with market prefix), e.g. HK.02337. |
stock_id | int | Stock ID (internal numeric identifier). |
stock_name | string | English name. |
sc_name | string | Simplified Chinese name. |
tc_name | string | Traditional Chinese name. |
stock_type | string | Security type. See Naming Dictionary. |
lot_size | int | Shares per lot (options=contract shares, futures=contract multiplier). |
list_time | int | Listing time (millisecond timestamp); returns 0 if no data. |
pagination.total | int | Total members in the plate. |
pagination.has_more | bool | Whether there is a next page. |
pagination.next_key | string | Next page cursor; "-1" when no more pages. |
Supported Markets
- Markets: HK / US / SH / SZ / SG / JP / CA / AU / MY 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 | Gateway failed to construct backend request | Retry; contact gateway 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 }
}