修改自選股

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