账户设置

获取账户信息

GET

https://api.bitget.com

/api/v3/account/info

限频规则: 5次/秒/UID

查询账户信息，包含用户ID、邀请人、母账户、渠道、IP白名单、权限类型及权限列表。

无需任何权限

获取账户信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

userId

string

用户ID

inviterId

string

邀请人UID

parentId

string

母账户UID 调用账户为子账户时，该字段有值

channelCode

string

渠道邀请码

channel

string

渠道

ips

string

IP白名单

permType

string

权限类型 read-only 只读 read-and-write 读写

permissions

string[]

权限列表 uta_mgt 统一账户管理 uta_trade 统一账户交易 withdraw 提币 copy_futures_position 合约带单持仓 copy_futures_order 合约带单订单

regisTime

string

账户注册时间（Unix时间戳，毫秒）

获取账户设置

GET

https://api.bitget.com

/api/v3/account/settings

限频规则: 20次/秒/UID

获取账户设置信息，包含持仓模式，保证金模式，杠杆倍数等等

需要统一账户管理只读/读写权限

获取账户设置 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

uid

string

用户ID

accountMode

string

账户模式 unified 统一模式 hybrid 混合模式 upgrading 统一账户升级中 switching 经典账户切换中

accountLevel

string

账户等级 basic 基础模式 advanced 进阶模式 isolated 逐仓模式 delta Delta中性模式

assetMode

string

资产模式 multi_assets 跨币种保证金模式

holdMode

string

持仓模式 one_way_mode 单向持仓 hedge_mode 双向持仓

stpMode

string

STP模式（自成交预防） none 不设置STP cancel_taker 取消taker单 cancel_maker 取消maker单 cancel_both 两者都取消

object[]

合约币对设置列表

object[]

杠杆业务线币种配置信息

GET/api/v3/account/settings

curl https://api.bitget.com/api/v3/account/settings

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1753787749280,
  "data": {
    "uid": "1111111111",
    "accountMode": "hybrid",
    "assetMode": "multi_assets",
    "accountLevel": "advanced",
    "holdMode": "one_way_mode",
    "stpMode": "none",
    "symbolConfigList": [
      {
        "category": "USDT-FUTURES",
        "symbol": "BGBUSDT",
        "marginMode": "crossed",
        "leverage": "20"
      },
      {
        "category": "USDT-FUTURES",
        "symbol": "BTCUSDT",
        "marginMode": "crossed",
        "leverage": "1"
      }
    ],
    "coinConfigList": [
      {
        "coin": "USDT",
        "leverage": "6"
      },
      {
        "coin": "BTC",
        "leverage": "3"
      }
    ]
  }
}

json

application/json

预设置调整杠杆

GET

https://api.bitget.com

/api/v3/account/pre-set-leverage

限频规则: 10次/秒/UID

预设置指定交易对的默认杠杆倍数。该接口仅返回调整后的预计最大可开（合约）/ 最大可借（杠杆）及所需保证金等信息，并不会真正修改账户的杠杆配置。

需要统一账户管理只读权限

预设置调整杠杆 › Request Parameters

category

string · required

产品类型 MARGIN 现货杠杆 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

marginMode

string · required

仓位模式 isolated 逐仓 cross 全仓

symbol

string

交易对名称更改合约时此参数必填

coin

string

杠杆币种更改杠杆时此参数必填

leverage

string

杠杆倍数适用于全仓模式适用于逐仓模式的单向持仓场景适用于逐仓模式的双向持仓下，不同方向设置相同杠杆倍数的场景

longLeverage

string

多仓杠杆仅适用于逐仓模式的双向持仓下，不同方向设置不同杠杆倍数的场景双向持仓场景下，如同时传参 leverage 和 longLeverage，则 longLeverage 生效，leverage 将被忽略

shortLeverage

string

空仓杠杆仅适用于逐仓模式的双向持仓下，不同方向设置不同杠杆倍数的场景双向持仓场景下，如同时传参 leverage 和 shortLeverage，则 shortLeverage 生效，leverage 将被忽略

预设置调整杠杆 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

estMaxOpen

string

调整后最大可开合约返回此参数

estMaxBorrowable

string

调整后最大可借杠杆返回此参数，单位为 coin

requiredMargin

string

所需保证金，单位为 USD

marginChange

string

占用保证金变化正值为增加，负值为减少

调整杠杆

POST

https://api.bitget.com

/api/v3/account/set-leverage

限频规则: 10次/秒/UID

调整杠杆倍数

需要统一账户管理读写权限

调整杠杆 › Request Parameters

category

string · required

产品类型 MARGIN 现货杠杆 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol

string

交易币对（更改合约时此参数必填）

leverage

string

杠杆倍数

coin

string

杠杆币种（更改杠杆时此参数必填）

posSide

string

仓位方向（逐仓时此参数必填） long 多仓 short 空仓

marginMode

string

仓位模式 crossed 全仓 isolated 逐仓如不填写则默认为全仓模式。本期仅合约业务线支持调整逐仓模式杠杆。

longLeverage

string

多仓杠杆仅适用于逐仓模式的双向持仓下，不同方向设置不同杠杆倍数的场景。双向持仓场景下，如同时传参 leverage 和 longLeverage，则 longLeverage 生效，leverage 将被忽略。

shortLeverage

string

空仓杠杆仅适用于逐仓模式的双向持仓下，不同方向设置不同杠杆倍数的场景。双向持仓场景下，如同时传参 leverage 和 shortLeverage，则 shortLeverage 生效，leverage 将被忽略。

调整杠杆 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

调整持仓模式

POST

https://api.bitget.com

/api/v3/account/set-hold-mode

限频规则: 10次/秒/UID

调整持仓模式，支持单向持仓与双向持仓之间切换。

需要统一账户管理读写权限

调整持仓模式 › Request Parameters

holdMode

string · required

持仓模式 one_way_mode 单向持仓，这种模式允许持有单一方向的仓位，要么是多头，要么是空头，但不能同时持有两者。 hedge_mode 双向持仓，这种模式允许同时持有多头和空头仓位

调整持仓模式 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

设置BGB抵扣

POST

https://api.bitget.com

/api/v3/account/switch-deduct

限频规则: 1次/秒/UID

目前仅现货交易支持BGB抵扣，合约交易暂不支持

需要统一账户管理读写权限

设置BGB抵扣 › Request Parameters

deduct

string · required

是否开启 on 开启 off 关闭

设置BGB抵扣 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

boolean

操作结果

获取BGB抵扣状态

GET

https://api.bitget.com

/api/v3/account/deduct-info

限频规则: 1次/秒/UID

获取BGB抵扣状态

需要统一账户管理只读/读写权限

获取BGB抵扣状态 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

deduct

string

是否开启 on 开启 off 关闭

账户切换

POST

https://api.bitget.com

/api/v3/account/switch

限频规则: 1次/秒/UID

仅母账户可调用此接口
接口仅用于切换至经典账户模式
请注意，由于账户切换处理需要约1分钟时间，您收到的成功响应仅表示请求已接收，并不代表账户已成功切换至经典账户
请使用查询切换状态接口，确认账户切换是否成功

账户切换 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

无返回数据

获取切换状态

GET

https://api.bitget.com

/api/v3/account/switch-status

限频规则: 5次/秒/UID

母账户可调用此接口

获取切换状态 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

status

string

账户切换状态 process 处理中 success 成功 fail 失败

reason

string

失败原因仅 status=fail 时返回，其余情况下为空

调整保证金

POST

https://api.bitget.com

/api/v3/account/set-margin

限频规则: 10次/秒/UID

调整逐仓保证金数量

需要统一账户管理读写权限

调整保证金 › Request Parameters

category

string · required

业务线 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol

string · required

交易对名称

posSide

string · required

仓位方向 long 多仓 short 空仓

operation

string · required

调整动作 add 增加 remove 移除

amount

string · required

保证金调整数量，单位为保证金币种 U本位合约单位为USDT，USDC合约单位为USDC，币本位合约单位为左币

调整保证金 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

获取Delta模式信息

GET

https://api.bitget.com

/api/v3/account/delta-info

限频规则: 20次/秒/UID

获取账户Delta中性模式下的信息，包含Delta权益比率和各币种合约净头寸比例。仅在账户开启Delta中性开关（deltaSwitch）时可用。

需要统一账户管理只读/读写权限

获取Delta模式信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

deltaEquityRatio

string

（废弃，不再作为对冲条件判断依据）Delta权益比率（小数形式，如 0.2 代表20%） ≤ 20%：账户处于中性状态，若仓位同时满足对冲条件，该账户合约仓位自动减仓（ADL）排序靠后，被减仓的概率更低

20%：账户非中性状态，该账户合约仓位将按正常规则参与自动减仓（ADL）排序

deltaThreshold

string

（废弃，不再作为对冲条件判断依据）Delta权益比率阈值。deltaThreshold 和 positionThreshold 均小于阈值时，允许当前账户进入ADL优先队列，否则仍处于普通队列

positionThreshold

string

币种净头寸比例阈值

object[]

币种持仓列表

账户模式切换

POST

https://api.bitget.com

/api/v3/account/adjust-account-mode

限频规则: 1次/秒/UID

该接口支持如下账户模式切换场景。支持统一账户下的基础模式及进阶模式间切换

母账户自身切换模式
子账户自身切换模式
母账户为其子账户切换模式

账户模式切换 › Request Parameters

mode

string · required

账户模式 basic 基础模式 advanced 进阶模式 delta Delta中性模式（废弃，请使用advanced模式配合deltaSwitch开关） isolated 逐仓模式

deltaSwitch

string

Delta中性开关，仅在mode为advanced时生效 yes 开启 no 关闭

targetUid

string

目标账户UID 若不传，默认为当前操作账户若传子账户UID，则为母账户操作子账户

账户模式切换 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

无返回数据

资产与余额杠杆与借贷管理

账户

账户设置

获取账户信息

GET

https://api.bitget.com

/api/v3/account/info

限频规则: 5次/秒/UID

查询账户信息，包含用户ID、邀请人、母账户、渠道、IP白名单、权限类型及权限列表。

无需任何权限

获取账户信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

userId

string

用户ID

inviterId

string

邀请人UID

parentId

string

母账户UID 调用账户为子账户时，该字段有值

channelCode

string

渠道邀请码

channel

string

渠道

ips

string

IP白名单

permType

string

权限类型 read-only 只读 read-and-write 读写

permissions

string[]

权限列表 uta_mgt 统一账户管理 uta_trade 统一账户交易 withdraw 提币 copy_futures_position 合约带单持仓 copy_futures_order 合约带单订单

regisTime

string

账户注册时间（Unix时间戳，毫秒）

获取账户设置

GET

https://api.bitget.com

/api/v3/account/settings

限频规则: 20次/秒/UID

获取账户设置信息，包含持仓模式，保证金模式，杠杆倍数等等

需要统一账户管理只读/读写权限

获取账户设置 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

uid

string

用户ID

accountMode

string

账户模式 unified 统一模式 hybrid 混合模式 upgrading 统一账户升级中 switching 经典账户切换中

accountLevel

string

账户等级 basic 基础模式 advanced 进阶模式 isolated 逐仓模式 delta Delta中性模式

assetMode

string

资产模式 multi_assets 跨币种保证金模式

holdMode

string

持仓模式 one_way_mode 单向持仓 hedge_mode 双向持仓

stpMode

string

STP模式（自成交预防） none 不设置STP cancel_taker 取消taker单 cancel_maker 取消maker单 cancel_both 两者都取消

object[]

合约币对设置列表

object[]

杠杆业务线币种配置信息

GET/api/v3/account/settings

curl https://api.bitget.com/api/v3/account/settings

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1753787749280,
  "data": {
    "uid": "1111111111",
    "accountMode": "hybrid",
    "assetMode": "multi_assets",
    "accountLevel": "advanced",
    "holdMode": "one_way_mode",
    "stpMode": "none",
    "symbolConfigList": [
      {
        "category": "USDT-FUTURES",
        "symbol": "BGBUSDT",
        "marginMode": "crossed",
        "leverage": "20"
      },
      {
        "category": "USDT-FUTURES",
        "symbol": "BTCUSDT",
        "marginMode": "crossed",
        "leverage": "1"
      }
    ],
    "coinConfigList": [
      {
        "coin": "USDT",
        "leverage": "6"
      },
      {
        "coin": "BTC",
        "leverage": "3"
      }
    ]
  }
}

json

application/json

预设置调整杠杆

GET

https://api.bitget.com

/api/v3/account/pre-set-leverage

限频规则: 10次/秒/UID

需要统一账户管理只读权限

预设置调整杠杆 › Request Parameters

category

string · required

产品类型 MARGIN 现货杠杆 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

marginMode

string · required

仓位模式 isolated 逐仓 cross 全仓

symbol

string

交易对名称更改合约时此参数必填

coin

string

杠杆币种更改杠杆时此参数必填

leverage

string

杠杆倍数适用于全仓模式适用于逐仓模式的单向持仓场景适用于逐仓模式的双向持仓下，不同方向设置相同杠杆倍数的场景

longLeverage

string

shortLeverage

string

预设置调整杠杆 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

estMaxOpen

string

调整后最大可开合约返回此参数

estMaxBorrowable

string

调整后最大可借杠杆返回此参数，单位为 coin

requiredMargin

string

所需保证金，单位为 USD

marginChange

string

占用保证金变化正值为增加，负值为减少

调整杠杆

POST

https://api.bitget.com

/api/v3/account/set-leverage

限频规则: 10次/秒/UID

调整杠杆倍数

需要统一账户管理读写权限

调整杠杆 › Request Parameters

category

string · required

产品类型 MARGIN 现货杠杆 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol

string

交易币对（更改合约时此参数必填）

leverage

string

杠杆倍数

coin

string

杠杆币种（更改杠杆时此参数必填）

posSide

string

仓位方向（逐仓时此参数必填） long 多仓 short 空仓

marginMode

string

仓位模式 crossed 全仓 isolated 逐仓如不填写则默认为全仓模式。本期仅合约业务线支持调整逐仓模式杠杆。

longLeverage

string

shortLeverage

string

调整杠杆 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

调整持仓模式

POST

https://api.bitget.com

/api/v3/account/set-hold-mode

限频规则: 10次/秒/UID

调整持仓模式，支持单向持仓与双向持仓之间切换。

需要统一账户管理读写权限

调整持仓模式 › Request Parameters

holdMode

string · required

调整持仓模式 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

设置BGB抵扣

POST

https://api.bitget.com

/api/v3/account/switch-deduct

限频规则: 1次/秒/UID

目前仅现货交易支持BGB抵扣，合约交易暂不支持

需要统一账户管理读写权限

设置BGB抵扣 › Request Parameters

deduct

string · required

是否开启 on 开启 off 关闭

设置BGB抵扣 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

boolean

操作结果

获取BGB抵扣状态

GET

https://api.bitget.com

/api/v3/account/deduct-info

限频规则: 1次/秒/UID

获取BGB抵扣状态

需要统一账户管理只读/读写权限

获取BGB抵扣状态 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

deduct

string

是否开启 on 开启 off 关闭

账户切换

POST

https://api.bitget.com

/api/v3/account/switch

限频规则: 1次/秒/UID

仅母账户可调用此接口
接口仅用于切换至经典账户模式
请注意，由于账户切换处理需要约1分钟时间，您收到的成功响应仅表示请求已接收，并不代表账户已成功切换至经典账户
请使用查询切换状态接口，确认账户切换是否成功

账户切换 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

无返回数据

获取切换状态

GET

https://api.bitget.com

/api/v3/account/switch-status

限频规则: 5次/秒/UID

母账户可调用此接口

获取切换状态 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

status

string

账户切换状态 process 处理中 success 成功 fail 失败

reason

string

失败原因仅 status=fail 时返回，其余情况下为空

调整保证金

POST

https://api.bitget.com

/api/v3/account/set-margin

限频规则: 10次/秒/UID

调整逐仓保证金数量

需要统一账户管理读写权限

调整保证金 › Request Parameters

category

string · required

业务线 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol

string · required

交易对名称

posSide

string · required

仓位方向 long 多仓 short 空仓

operation

string · required

调整动作 add 增加 remove 移除

amount

string · required

保证金调整数量，单位为保证金币种 U本位合约单位为USDT，USDC合约单位为USDC，币本位合约单位为左币

调整保证金 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

获取Delta模式信息

GET

https://api.bitget.com

/api/v3/account/delta-info

限频规则: 20次/秒/UID

获取账户Delta中性模式下的信息，包含Delta权益比率和各币种合约净头寸比例。仅在账户开启Delta中性开关（deltaSwitch）时可用。

需要统一账户管理只读/读写权限

获取Delta模式信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

deltaEquityRatio

string

20%：账户非中性状态，该账户合约仓位将按正常规则参与自动减仓（ADL）排序

deltaThreshold

string

positionThreshold

string

币种净头寸比例阈值

object[]

币种持仓列表

账户模式切换

POST

https://api.bitget.com

/api/v3/account/adjust-account-mode

限频规则: 1次/秒/UID

该接口支持如下账户模式切换场景。支持统一账户下的基础模式及进阶模式间切换

母账户自身切换模式
子账户自身切换模式
母账户为其子账户切换模式

账户模式切换 › Request Parameters

mode

string · required

账户模式 basic 基础模式 advanced 进阶模式 delta Delta中性模式（废弃，请使用advanced模式配合deltaSwitch开关） isolated 逐仓模式

deltaSwitch

string

Delta中性开关，仅在mode为advanced时生效 yes 开启 no 关闭

targetUid

string

目标账户UID 若不传，默认为当前操作账户若传子账户UID，则为母账户操作子账户

账户模式切换 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

无返回数据

资产与余额杠杆与借贷管理