Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
交易
    订单管理
      下单post修改订单post撤单post倒计时全部撤单post批量下单post批量修改订单post批量撤单post一键撤单post获取订单信息get获取当前委托get获取历史委托get获取成交明细get创建Reality股票订单post撤销Reality股票订单post
    仓位管理
      获取最大可开可用post一键平仓post仓位转移post获取移仓历史get获取当前仓位get获取历史仓位get获取仓位ADL排名get获取借币数据get
    策略交易
      创建策略单post修改策略单post撤销策略单post获取当前策略单get获取历史策略单get获取历史策略子订单get
    网格交易
      追加投资额post查询网格交易机器人详情get终止网格交易机器人post创建网格交易机器人post创建中性网格交易机器人post查询网格交易机器人挂单详情get修改网格交易机器人参数post修改网格区间和网格数post修改中性网格交易机器人参数post修改中性网格区间和网格数post查询中性网格交易机器人详情get查询中性网格机器人挂单详情get验证中性网格参数post验证网格输入post
    STP 分组
      创建 STP 分组post查询 STP 分组列表get添加 STP 分组成员post移除 STP 分组成员post
交易
交易

STP 分组

STP 分组


创建 STP 分组

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

创建自定义自成交预防(STP)分组。同一分组内的子账户之间不会相互撮合;不同分组的子账户可以正常互相交易。

注意:该接口仅对 MM(做市商) 白名单用户开放。

  • 限频规则: 20次/秒/UID

  • 权限:统一账户管理 — 读写

创建 STP 分组 › Request Parameters

groupName
​string · required

STP Group 名称

最长 32 个字符,需唯一

创建 STP 分组 › Response Parameters

200

Successful response

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

STP Group ID(系统自动生成的数字 ID)

groupName
​string

STP Group 名称

createdTime
​string

创建时间,Unix 毫秒时间戳

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

查询 STP 分组列表

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

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

注意:该接口仅对 MM(做市商) 白名单用户开放。

  • 限频规则: 20次/秒/UID

  • 权限:统一账户管理 — 只读

查询 STP 分组列表 › Response Parameters

200

Successful response

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

STP Group 列表

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

添加 STP 分组成员

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

将子账户添加到已有的 STP Group。每个子账户只能属于一个 STP Group;将子账户加入新 Group 时会自动退出原 Group。

注意:该接口仅对 MM(做市商) 白名单用户开放。

  • 限频规则: 20次/秒/UID

  • 权限:统一账户管理 — 读写

添加 STP 分组成员 › Request Parameters

uids
​string · required

要加入 Group 的子账户 UID 列表

单次最多 50 个;只能添加本母账户下的子账户。多个 UID 之间逗号分隔。

groupId
​string · required

STP Group ID

添加 STP 分组成员 › Response Parameters

200

Successful response

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

创建时间,Unix 毫秒时间戳

​object[]

成功加入的 UID 列表

​object[]

失败的 UID 列表

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

移除 STP 分组成员

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

将子账户从 STP Group 中移除。移除后,子账户回退到默认行为(stp_uid = parent_uid)。

注意:该接口仅对 MM(做市商) 白名单用户开放。

  • 限频规则: 20次/秒/UID

  • 权限:统一账户管理 — 读写

移除 STP 分组成员 › Request Parameters

uids
​string · required

要移除的子账户 UID 列表

单次最多 50 个;只能移除当前 STP 组内的子账户。多个 UID 之间逗号分隔。

groupId
​string · required

STP Group ID

移除 STP 分组成员 › Response Parameters

200

Successful response

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

创建时间,Unix 毫秒时间戳

​object[]

成功移除的 UID 列表

​object[]

失败移除的 UID 列表

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

网格交易