Get STP Group List

Description

Query the custom STP Group list and member sub-accounts under the current master account.

Note: This endpoint is only available to MM (Market Maker) whitelist users.

HTTP Request

• GET /api/v3/account/stp-groups
• Rate limit: 20/sec/UID
• Permission: UTA mgt. (read)

Request

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:en-US" \
   -H "Content-Type: application/json"

Request Parameters

This endpoint has no request parameters.

Response

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

Response Parameters

Parameter	Type	Description
groups	Array	STP Group list
> groupId	String	STP Group ID
> groupName	String	STP Group name
> createdTime	String	Creation time, Unix millisecond timestamp
> members	Array	Member list
>> uid	String	Sub-account UID
>> joinedTime	String	Time joined, Unix millisecond timestamp