修改自选股

POST /v1/quote/modify-user-security

修改用户自选股：把标的加入某分组、仅从某分组移出、或从所有分组彻底删除。查询自选分组用 user-security-group；查询分组下自选用 user-security。

请求参数

参数	类型	位置	必填	说明
group_name	string	请求体	否	自选分组名（同名取首个），最长 100 字符；仅支持自定义分组。op=ADD/MOVE_OUT 必填；op=DEL 可不填。
op	string	请求体	是	操作类型：ADD=加入指定分组 / DEL=从所有分组彻底删除 / MOVE_OUT=仅从指定分组移出。
code_list	string[]	请求体	是	股票代码列表，必须非空，单次 1-200 个。例：["HK.00700","US.AAPL"]。
X-Futu-Client-Nnid	string	请求头	是	用户身份（牛牛号）。

请求示例

curl -X POST "$ip/v1/quote/modify-user-security" \
  -H "Content-Type: application/json" \
  -H "X-Futu-Client-Nnid: 99034182" \
  -d '{"group_name":"我的自选","op":"ADD","code_list":["HK.00700","US.AAPL"]}' | jq

响应字段

字段	类型	说明
result_code	int	操作结果码，成功恒为 0。

限制范围

• 市场：支持全部市场（HK / US / CN / SG / JP / 加密货币等），凡能解析出证券的合法代码均可。
• 品类：支持正股 / ETF / 窝轮 / 期权 / 期货 / 指数 / 债券等全部品类。
• 分组：ADD / MOVE_OUT 针对单个自定义分组（一次一个 group_name）；系统预置分组不作为操作目标。DEL 不依赖分组，从所有分组移除。
• code_list 单次最多 200 个。

错误码

ret_code	error.code	触发条件	处理建议
-3	invalid_parameter	缺 op / op 非法 / code_list 为空或 >200 / group_name >100 字符 / op=ADD|MOVE_OUT 缺 group_name / 分组不存在 / 代码格式错误。	校正请求参数后重试。
-7	invalid_symbol	code_list 中代码格式合法但查无此证券。	通过 search 确认代码合法性。
-8	unsupported	对系统 / 虚拟分组做非法增删。	改用自定义分组。
-9	permission_denied	缺 X-Futu-Client-Nnid 身份 / 身份无效。	补充用户身份后重试。
-5	internal_error	网关或后端内部错误。	稍后重试，持续失败联系支持。

响应示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "result_code": 0
  }
}