获取自选股分组

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" }
    ]
  }
}