所屬板塊
GET/v1/quote/{symbol}/owner-plate獲取股票所屬的行業/概念板塊。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 標的代碼,例如 HK.00700。 |
請求示例
bash
curl '$ip/v1/quote/HK.00700/owner-plate' | jq響應字段
返回 data.sectors[],每元素一個所屬板塊。無所屬板塊的標的(指數 / 部分外盤冷門股)按空數組返回。
| 字段 | 類型 | 說明 |
|---|---|---|
name | string | 被查詢標的的名稱(即 symbol 對應的證券名稱,並非板塊名),例:富途控股 / 騰訊控股 |
plate_code | string | 板塊代碼(含市場前綴,可作 stock 訂閱 code),例:HK.LIST1284 / US.LIST2517 |
plate_name | string | 板塊名稱(簡體),例:熱門中概股 / 資本市場 |
plate_type | string | 板塊類型,詳見命名詞典 > plate_type |
限制範圍
- 支持市場:HK / US / SH / SZ / SG / JP / AU / CA / MY / KR。
- 支持品類:正股 / ETF。指數(INDEX)、窩輪 / 牛熊 / 期權 / 期貨 / 債券通常無板塊,按空
sectors返回。 - 單標的查詢;如需批量查詢請按 symbol 多次調用。
錯誤碼
| ret_code | error.code | 觸發條件 | 處理建議 |
|---|---|---|---|
| -3 | invalid_parameter | symbol 缺失或格式不合法(必須形如 MARKET.CODE,超 32 字符或不含 .) | 檢查路徑參數 symbol,例:HK.00700 |
| -7 | invalid_symbol | symbol 格式合法但後端找不到對應證券 | 通過 search 接口確認 symbol 合法性 |
| -4 | internal_error | 網關後端調用 / 響應映射失敗 | 稍後重試;持續失敗請反饋 |
響應示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"sectors": [
{ "name": "富途控股", "plate_code": "US.LIST2517", "plate_name": "热门中概股", "plate_type": "CONCEPT" },
{ "name": "富途控股", "plate_code": "US.LIST2260", "plate_name": "资本市场", "plate_type": "INDUSTRY" },
{ "name": "富途控股", "plate_code": "US.LIST2701", "plate_name": "中东ETF", "plate_type": "OTHER" }
]
}
}