所屬板塊
GET/api/v1.0/quote/{symbol}/owner-plate獲取單個標的所屬的行業 / 概念板塊清單。返回每個板塊的代碼(含市場前綴,可作 stock 訂閱 code)、板塊名稱和板塊類型。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 標的代碼(含市場前綴),例:HK.00700 / US.FUTU / SH.600036 |
請求示例
bash
curl -s "https://webapi.futunn.com/api/v1.0/quote/HK.00700/owner-plate" | jq
curl -s "https://webapi.futunn.com/api/v1.0/quote/US.FUTU/owner-plate" | jq響應字段
返回 data.sectors[],每元素一個所屬板塊。無所屬板塊的標的(指數 / 部分外盤冷門股)按空數組返回。
| 參數 | 類型 | 説明 |
|---|---|---|
data | object | |
data.sectors | object[] | |
data.sectors[].name | string | 股票英文名(被查詢的標的本身),例: FUTU / TENCENT |
data.sectors[].sc_name | string | 股票簡體中文名,例: 富途控股 / 騰訊控股 |
data.sectors[].tc_name | string | 股票繁體中文名,例: 富途控股 / 騰訊控股 |
data.sectors[].plate_code | string | 板塊代碼,例: US.LIST2517 |
data.sectors[].plate_name | string | 板塊英文名,例: Popular Chinese Concept Stocks |
data.sectors[].plate_sc_name | string | 板塊簡體中文名,例: 熱門中概股 / 資本市場 |
data.sectors[].plate_tc_name | string | 板塊繁體中文名,例: 熱門中概股 / 資本市場 |
data.sectors[].plate_type | string | 板塊類型,取值: INDUSTRY(行業)/ CONCEPT(概念)/ OTHER(其它) |
pagination | object | 部分接口返回分頁信息 |
限制範圍
- code 必須是已開通行情前綴必須落在下列 10 個市場內,否則返回
invalid_symbol: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"
}
]
}
}