Skip to content

板塊列表

GET /v1/quote/plate-list

獲取指定市場指定板塊分類下的所有板塊列表。

請求參數

參數類型位置必填說明
marketstring查詢市場前綴。詳見命名詞典
plate_classstring查詢板塊分類:ALL / INDUSTRY / REGION / CONCEPT / OTHER。詳見命名詞典

請求示例

bash
curl '$ip/v1/quote/plate-list?market=HK&plate_class=INDUSTRY' | jq

響應字段

返回 data.plate_list[],每元素一個板塊:

字段類型說明
codestring板塊代碼(含市場前綴),如 HK.LIST23618
plate_idstring板塊 ID(不含市場前綴),如 LIST23618
plate_namestring板塊簡稱。

限制範圍

  • 市場:詳見命名詞典(10 個市場)。
  • 板塊分類:REGION 僅 SH / SZ 支持,其他市場傳入返回 unsupported
  • 後端無數據時(如 KR 當前無成分板塊)按空 plate_list 返回。

錯誤碼

ret_codeerror.code觸發條件處理建議
0成功
-3invalid_parametermarketplate_class;取值不在枚舉內(區分大小寫)校正參數後重試
-8unsupportedplate_class=REGIONmarket 不是 SH / SZ改用 SH / SZ;其他市場暫無地域板塊
-5internal_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": "個人護理" }
    ]
  }
}