获取自选股分组
GET/api/v1.0/quote/user-security-group获取用户自选股的分组列表(含系统预置分组与用户自定义分组)。获取分组下的自选股请用 user-security;增加/移出自选请用 modify-user-security。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
group_type | string | 查询 | 否 | 分组类型过滤,默认 ALL。取值:ALL=全部 / SYSTEM=系统预置 / CUSTOM=用户自定义。 |
请求示例
bash
curl "https://webapi.futunn.com/api/v1.0/quote/user-security-group?group_type=ALL" | jq响应字段
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.group_list | object[] | |
data.group_list[].group_name | string | 分组名称。系统分组英文化(例: All / US / HK / Favorites),自定义分组为用户原名(例: 我的自选) |
data.group_list[].group_type | string | 分组类型,取值: SYSTEM(系统预置)/ CUSTOM(用户自定义) |
pagination | object | 部分接口返回分页信息 |
限制范围
- 仅返回用户当前可见的分组(用户已隐藏的分组不返回)。
- 持仓、外汇、基金分组不在返回范围内。
- 系统分组(group_type=SYSTEM)完整名称集(最多 19 个):All、Favorites、HK、US、CN、HK Options、US Options、Options、Futures、Index、Bonds、Notes、Crypto、SG、JP、MY、AU、CA。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| -3 | invalid_parameter | group_type 取值不在 [ALL, CUSTOM, SYSTEM](大小写敏感)。 | 修正 group_type 后重试。 |
| -9 | permission_denied | 用户身份缺失/无效。 | 补齐用户身份后重试。 |
| -5 | internal_error | 服务错误 | 稍后重试,持续失败请联系服务方。 |
响应示例
json
{
"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"
}
]
}
}