Get User Security Group

GET /api/v1.0/quote/user-security-group

Get the user's watchlist group list (including system preset groups and user custom groups). Use user-security to get symbols in a group; use modify-user-security to add/remove symbols.

Parameters

Name	Type	In	Required	Description
group_type	string	query	no	Group type filter. Default ALL. Values: ALL=all / SYSTEM=system preset / CUSTOM=user custom.

Request Example

curl "https://webapi.moomoo.com/api/v1.0/quote/user-security-group?group_type=ALL" | jq

Response Fields

Field	Type	Description
group_list	object[]	List of groups.
group_list[].group_name	string	Group name. System groups use English names (All / US / HK / Favorites, etc.), custom groups use user-defined names.
group_list[].group_type	string	Group type: SYSTEM / CUSTOM.

Supported Markets

• Only returns groups currently visible to the user (hidden groups are excluded).
• Holdings, forex, and fund groups are not included in the response.
• System groups (group_type=SYSTEM) full name set (up to 19): All, Favorites, HK, US, CN, HK Options, US Options, Options, Futures, Index, Bonds, Notes, Crypto, SG, JP, MY, AU, CA.

Error Codes

ret_code	error.code	Trigger Condition	Handling
-3	invalid_parameter	group_type value not in [ALL, CUSTOM, SYSTEM] (case-sensitive).	Correct group_type and retry.
-9	permission_denied	User identity missing/invalid.	Add user identity and retry.
-5	internal_error	Backend watchlist service call failed.	Retry later; contact support if persistent.

Response Example

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