Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Trading
    Order Management
      Place OrderpostModify OrderpostCancel OrderpostBatch OrderpostBatch Modify OrderspostBatch CancelpostCancel All OrderspostGet Order DetailsgetGet Open OrdersgetGet Order HistorygetGet Fill HistorygetCountDown Cancel AllpostPlace Reality OrderpostCancel Reality Orderpost
    Position Management
      Close All PositionspostMove PositionspostGet Move Position HistorygetGet Position InfogetGet Positions HistorygetGet Max Open AvailablepostGet Position ADL RankgetGet Loan Dataget
    Strategy Trading
      Place Strategy OrderpostModify Strategy OrderpostCancel Strategy OrderpostUnfilled Strategy OrdersgetHistory Strategy OrdersgetGet Strategy Sub-ordersget
    Grid Trading
      Add Investment AmountpostGet Grid Bot DetailgetClose Grid BotpostCreate Grid BotpostCreate Neutral Grid BotpostGet Grid Bot Order DetailsgetModify Grid Bot ParameterspostModify Grid Interval and Grid NumberpostModify Neutral Grid Bot ParameterspostModify Neutral Grid Interval and Grid NumberpostGet Neutral Grid Bot DetailgetGet Neutral Grid Bot Order DetailsgetValidate Neutral Grid ParameterspostValidate Grid Parameterspost
    STP Group
      Create STP GrouppostGet STP Group ListgetAdd STP Group MemberspostRemove STP Group Memberspost
Trading
Trading

STP Group

STP Group


Create STP Group

POST
https://api.bitget.com
/api/v3/account/create-stp-groups

Create a custom Self-Trade Prevention (STP) group. Sub-accounts within the same group will not match against each other; sub-accounts in different groups can trade with each other normally.

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

  • Rate limit: 20/sec/UID

  • Permission: UTA mgt. (read & write)

Create STP Group › Request Parameters

groupName
​string · required

STP Group name

Max 32 characters, must be unique

Create STP Group › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
groupId
​string

STP Group ID (system-generated numeric ID)

groupName
​string

STP Group name

createdTime
​string

Creation time, Unix millisecond timestamp

POST/api/v3/account/create-stp-groups
curl https://api.bitget.com/api/v3/account/create-stp-groups \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "groupName": "groupName" }'
Example Request Body
{ "groupName": "groupName" }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1729760000000, "data": { "groupId": "1001", "groupName": "Team-A", "createdTime": "1729760000000" } }
json
application/json

Get STP Group List

GET
https://api.bitget.com
/api/v3/account/stp-groups

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.

  • Rate limit: 20/sec/UID

  • Permission: UTA mgt. (read)

Get STP Group List › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
​object[]

STP Group list

GET/api/v3/account/stp-groups
curl https://api.bitget.com/api/v3/account/stp-groups
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1729760000000, "data": { "groups": [ { "groupId": "1001", "groupName": "Team-A", "createdTime": "1729760000000", "members": [ { "uid": "1122334455", "joinedTime": "1729760100000" } ] } ] } }
json
application/json

Add STP Group Members

POST
https://api.bitget.com
/api/v3/account/add-groups-members

Add sub-accounts to an existing STP Group. Each sub-account can only belong to one STP Group; adding a sub-account to a new group automatically removes it from its previous group.

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

  • Rate limit: 20/sec/UID

  • Permission: UTA mgt. (read & write)

Add STP Group Members › Request Parameters

uids
​string · required

Sub-account UIDs to add to the group

Max 50 per call; can only add sub-accounts under this master account. Multiple UIDs separated by commas.

groupId
​string · required

STP Group ID

Add STP Group Members › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
createdTime
​string

Creation time, Unix millisecond timestamp

​object[]

Successfully added UID list

​object[]

Failed UID list

POST/api/v3/account/add-groups-members
curl https://api.bitget.com/api/v3/account/add-groups-members \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "uids": "uids", "groupId": "groupId" }'
Example Request Body
{ "uids": "uids", "groupId": "groupId" }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1729760000000, "data": { "createdTime": "1729760000000", "successUids": [ { "uid": "1122334455" } ], "failedUids": [] } }
json
application/json

Remove STP Group Members

POST
https://api.bitget.com
/api/v3/account/remove-groups-members

Remove sub-accounts from an STP Group. After removal, a sub-account reverts to the default behavior (stp_uid = parent_uid).

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

  • Rate limit: 20/sec/UID

  • Permission: UTA mgt. (read & write)

Remove STP Group Members › Request Parameters

uids
​string · required

Sub-account UIDs to remove from the group

Max 50 per call; can only remove sub-accounts currently in this STP Group. Multiple UIDs separated by commas.

groupId
​string · required

STP Group ID

Remove STP Group Members › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
createdTime
​string

Creation time, Unix millisecond timestamp

​object[]

Successfully removed UID list

​object[]

Failed removed UID list

POST/api/v3/account/remove-groups-members
curl https://api.bitget.com/api/v3/account/remove-groups-members \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "uids": "uids", "groupId": "groupId" }'
Example Request Body
{ "uids": "uids", "groupId": "groupId" }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1729760000000, "data": { "createdTime": "1729760000000", "successUids": [ { "uid": "1122334455" } ], "failedUids": [] } }
json
application/json

Grid Trading