獲取自選股分組

GET /v1/quote/user-security-group

獲取用戶自選股的分組列表（含系統預置分組與用戶自定義分組）。獲取分組下的自選股請用 user-security；增加/移出自選請用 modify-user-security。

請求參數

參數	類型	位置	必填	說明
group_type	string	查詢	否	分組類型過濾，默認 ALL。取值：ALL=全部 / SYSTEM=系統預置 / CUSTOM=用戶自定義。
X-Futu-Client-Nnid	string	請求頭	是	用戶身份（牛牛號）。

請求示例

curl "$ip/v1/quote/user-security-group?group_type=ALL" \
  -H "X-Futu-Client-Nnid: 241175593" | jq

響應字段

字段	類型	說明
group_list	object[]	分組列表。
group_list[].group_name	string	分組名稱。系統分組為英文（All / US / HK / Favorites 等），自定義分組為用戶原名。
group_list[].group_type	string	分組類型：SYSTEM / CUSTOM。

限制範圍

• 用戶級接口，必須在請求頭攜帶 X-Futu-Client-Nnid（用戶牛牛號），缺失返回 permission_denied。
• 僅返回用戶當前可見的分組（用戶已隱藏的分組不返回）。
• 持倉、外匯、基金分組不在返回範圍內。
• 系統分組（group_type=SYSTEM）完整名稱集（最多 19 個）：All、Favorites、HK、US、CN、HK Options、US Options、Options、Futures、Index、Bonds、Notes、Crypto、SG、JP、Korean Stocks、MY、AU、CA。

錯誤碼

ret_code	error.code	觸發條件	處理建議
-3	invalid_parameter	group_type 取值不在 [ALL, CUSTOM, SYSTEM]（大小寫敏感）。	修正 group_type 後重試。
-9	permission_denied	未攜帶 X-Futu-Client-Nnid 用戶身份。	請求頭補充用戶牛牛號後重試。
-5	internal_error	後端自選服務調用失敗。	稍後重試，持續失敗請聯繫服務方。

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "group_list": [
      { "group_name": "All", "group_type": "SYSTEM" },
      { "group_name": "Favorites", "group_type": "SYSTEM" },
      { "group_name": "HK", "group_type": "SYSTEM" },
      { "group_name": "US", "group_type": "SYSTEM" },
      { "group_name": "Options", "group_type": "SYSTEM" },
      { "group_name": "我的自選", "group_type": "CUSTOM" }
    ]
  }
}