板塊列表
GET/v1/quote/plate-list獲取指定市場指定板塊分類下的所有板塊列表。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
market | string | 查詢 | 是 | 市場前綴。詳見命名詞典。 |
plate_class | string | 查詢 | 是 | 板塊分類:ALL / INDUSTRY / REGION / CONCEPT / OTHER。詳見命名詞典。 |
請求示例
bash
curl '$ip/v1/quote/plate-list?market=HK&plate_class=INDUSTRY' | jq響應字段
返回 data.plate_list[],每元素一個板塊:
| 字段 | 類型 | 說明 |
|---|---|---|
code | string | 板塊代碼(含市場前綴),如 HK.LIST23618。 |
plate_id | string | 板塊 ID(不含市場前綴),如 LIST23618。 |
plate_name | string | 板塊簡稱。 |
限制範圍
- 市場:詳見命名詞典(10 個市場)。
- 板塊分類:
REGION僅 SH / SZ 支持,其他市場傳入返回unsupported。 - 後端無數據時(如 KR 當前無成分板塊)按空
plate_list返回。
錯誤碼
| ret_code | error.code | 觸發條件 | 處理建議 |
|---|---|---|---|
| 0 | — | 成功 | — |
| -3 | invalid_parameter | 缺 market 或 plate_class;取值不在枚舉內(區分大小寫) | 校正參數後重試 |
| -8 | unsupported | plate_class=REGION 但 market 不是 SH / SZ | 改用 SH / SZ;其他市場暫無地域板塊 |
| -5 | internal_error | 後端調用失敗(網絡 / 超時 / RPC 錯誤) | 重試 |
響應示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"plate_list": [
{ "code": "HK.LIST23618", "plate_id": "LIST23618", "plate_name": "光學媒體" },
{ "code": "HK.LIST1062", "plate_id": "LIST1062", "plate_name": "個人護理" }
]
}
}