查询 STP 分组列表

描述

查询当前母账户下的自定义 STP Group 列表及成员子账户。

注意：该接口仅对 MM（做市商） 白名单用户开放。

HTTP请求

• GET /api/v3/account/stp-groups
• 限频规则: 20次/秒/UID
• 权限：统一账户管理 — 只读

请求示例

curl -X GET "https://api.bitget.com/api/v3/account/stp-groups" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:zh-CN" \
   -H "Content-Type: application/json"

请求参数

该接口无请求参数。

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1729760000000,
  "data": {
    "groups": [
      {
        "groupId": "1",
        "groupName": "Test1",
        "createdTime": "1729760000000",
        "members": [
          {
            "uid": "12345",
            "joinedTime": "1729760100000"
          }
        ]
      }
    ]
  }
}

返回参数

返回字段	参数类型	字段说明
groups	Array	STP Group 列表
> groupId	String	STP Group ID
> groupName	String	STP Group 名称
> createdTime	String	创建时间，Unix 毫秒时间戳
> members	Array	成员列表
>> uid	String	子账户 UID
>> joinedTime	String	加入时间，Unix 毫秒时间戳