资产与余额

获取账户资产

GET

https://api.bitget.com

/api/v3/account/assets

限频规则: 20次/秒/UID

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

获取资产账户信息，仅返回有资产的币种

获取账户资产 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

accountEquity

string

账户总权益 (USD)

usdtEquity

string

账户总权益（USDT）

btcEquity

string

账户总权益（BTC）

unrealisedPnl

string

账户总的未实现盈亏 (USD)

usdtUnrealisedPnl

string

账户总的未实现盈亏（USDT）

btcUnrealizedPnl

string

账户总的未实现盈亏（BTC）

effEquity

string

有效权益 USD, 账户中可为全仓模式下的现货、永续合约交易提供保证金的资产折合成法币价值的净值

mmr

string

维持保证金 USD, 是用户维持当前仓位所需的最低保证金

imr

string

初始保证金 USD, 账户中所有全仓持仓及挂单的保证金折合成法币价值的净值

mgnRatio

string

维持保证金率

positionMgnRatio

string

仓位维持保证金比率

positionValue

string

仓位价值单位为USD

leverage

string

账户杠杆非负数

object[]

账户币种列表

GET/api/v3/account/assets

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

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1746687063471,
  "data": {
    "accountEquity": "11.13919278",
    "usdtEquity": "11.13921165",
    "btcEquity": "0.00011256",
    "unrealisedPnl": "0",
    "usdtUnrealisedPnl": "0",
    "btcUnrealizedPnl": "0",
    "effEquity": "6.19299777",
    "mmr": "0",
    "imr": "0",
    "mgnRatio": "0",
    "positionMgnRatio": "0",
    "positionValue": "0",
    "leverage": "1",
    "assets": [
      {
        "coin": "USDT",
        "equity": "6.19300826",
        "usdValue": "6.19299777",
        "balance": "6.19300826",
        "available": "6.19300826",
        "debt": "0",
        "locked": "0",
        "bonus": "10"
      },
      {
        "coin": "BGB",
        "equity": "1.15582129",
        "usdValue": "4.94618029",
        "balance": "1.15582129",
        "available": "1.15582129",
        "debt": "0",
        "locked": "0",
        "bonus": "0"
      }
    ]
  }
}

json

application/json

获取资金账户资产

GET

https://api.bitget.com

/api/v3/account/funding-assets

限频规则: 20次/秒/UID

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

获取资金账户信息，仅返回有资产的币种。

注：Pre-IPO 类型币种的 coin 字段大小写混用，如 preSPAX，请注意大小写，以获取币种信息接口里返回的 coin 为准

获取资金账户资产 › Request Parameters

coin

string

币种名称

获取资金账户资产 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

coin

string

币种名称

balance

string

总余额单位为当前资产币种

available

string

可用单位为当前资产币种

frozen

string

冻结单位为当前资产币种

获取财务记录

GET

https://api.bitget.com

/api/v3/account/financial-records

限频规则: 20次/秒/UID

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

获取账户90天内流水信息

获取财务记录 › Request Parameters

category

string · required

产品类型 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约 OTHER 其它

coin

string

币种例如，BTC

type

string

账户流水类型 TRANSFER_IN/TRANSFER_OUT...... 详细枚举可以在枚举页面获取

startTime

string

开始时间戳 Unix时间戳的毫秒数格式，如 1597026383085 最大查询范围90天

endTime

string

结束时间戳 Unix时间戳的毫秒数格式，如 1597026383085 startTime和endTime间隔不超过30天

limit

string

查询条数最大100，默认100

cursor

string

分页游标用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回cursor

获取财务记录 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

账务流水列表

cursor

string

分页游标

获取资金账户财务流水

GET

https://api.bitget.com

/api/v3/account/funding-financial-records

限频规则: 10次/秒/UID

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

获取资金账户财务流水，最大查询范围90天

获取资金账户财务流水 › Request Parameters

coin

string

币种
例如，BTC

type

string

账户流水类型
TRANSFER_IN/TRANSFER_OUT......
详细枚举可以在枚举页面获取

startTime

string

开始时间戳
Unix时间戳的毫秒数格式，如 1597026383085
最大查询范围90天

endTime

string

结束时间戳
Unix时间戳的毫秒数格式，如 1597026383085
startTime和endTime间隔不超过30天

limit

string

查询条数最大100，默认100

cursor

string

分页游标
用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回cursor

获取资金账户财务流水 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

账务流水列表

cursor

string

分页游标

获取交易手续费

GET

https://api.bitget.com

/api/v3/account/fee-rate

限频规则: 3次/秒/UID

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

获取交易手续费

获取交易手续费 › Request Parameters

symbol

string · required

交易对名称如BTCUSDT

category

string · required

业务线 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

获取交易手续费 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

makerFeeRate

string

挂单手续费率小数形式，即0.0002代表万分之二

takerFeeRate

string

吃单手续费率小数形式，即0.0002代表万分之二

获取最大可转出

GET

https://api.bitget.com

/api/v3/account/max-transferable

限频规则: 3次/秒/UID

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

获取统一账户最大可转出

获取最大可转出 › Request Parameters

coin

string · required

币种名称

获取最大可转出 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

coin

string

币种名称

maxTransfer

string

最大可转出单位为coin

borrowMaxTransfer

string

借币最大可转出单位为coin

获取最大可提币数量

GET

https://api.bitget.com

/api/v3/account/max-withdrawal

限频规则: 10次/秒/UID

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

查询当前统一账户指定币种的最大可提币数量。该额度由平台综合账户可用余额、未结清持仓、负债占用等因素实时计算，适用于用户在发起提币前预先获取安全提币上限，避免因超限而导致提币失败。

注意：返回结果为实时计算值，存在毫秒级延迟；实际提币时平台仍会进行二次校验，该接口结果仅供参考。

获取最大可提币数量 › Request Parameters

coin

string · required

币种名称，如 USDT

获取最大可提币数量 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

coin

string

币种名称

otcMaxWithdrawal

string

OTC账户最大可提币数量

spotMaxWithdrawal

string

现货账户最大可提币数量

utaMaxWithdrawal

string

统一账户最大可提币数量

totalMaxWithdrawal

string

全部最大可提币数量

设置抵押品模式

POST

https://api.bitget.com

/api/v3/account/set-collateral-type

限频规则: 2次/秒/UID

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

设置当前统一账户的抵押品模式。

设置抵押品模式 › Request Parameters

collateralType

string · required

抵押品模式 mainstream 主流币 all 全部币种 custom 自定义

collateralCoins

string

抵押品币种名称支持多个币种，使用英文逗号分隔自定义模式 collateralType=custom 必填

设置抵押品模式 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

获取抵押品模式

GET

https://api.bitget.com

/api/v3/account/collateral-type

限频规则: 10次/秒/UID

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

查询当前统一账户的抵押品模式设置。抵押品模式分为主流币、全部币种和自定义。主流币模式下支持 USDT、USDC、BTC、DOGE、ETH、SOL 作为抵押品；自定义模式下用户可自行指定生效的抵押品币种。

获取抵押品模式 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

collateralType

string

抵押品模式 mainstream 主流币 all 全部币种 custom 自定义

collateralCoins

string

抵押品币种仅 collateralType=custom 自定义模式返回，多个币种之间使用英文逗号分隔

获取自定义抵押品支持币种

GET

https://api.bitget.com

/api/v3/account/custom-collateral-coins

限频规则: 10次/秒/IP

查询系统支持作为自定义抵押品的所有币种。该接口为公共接口，返回平台层支持的完整列表，与用户个人配置无关。

获取自定义抵押品支持币种 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

collateralCoin

string

抵押品币种名称

账户设置

账户

资产与余额

获取账户资产

GET

https://api.bitget.com

/api/v3/account/assets

限频规则: 20次/秒/UID

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

获取资产账户信息，仅返回有资产的币种

获取账户资产 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

accountEquity

string

账户总权益 (USD)

usdtEquity

string

账户总权益（USDT）

btcEquity

string

账户总权益（BTC）

unrealisedPnl

string

账户总的未实现盈亏 (USD)

usdtUnrealisedPnl

string

账户总的未实现盈亏（USDT）

btcUnrealizedPnl

string

账户总的未实现盈亏（BTC）

effEquity

string

有效权益 USD, 账户中可为全仓模式下的现货、永续合约交易提供保证金的资产折合成法币价值的净值

mmr

string

维持保证金 USD, 是用户维持当前仓位所需的最低保证金

imr

string

初始保证金 USD, 账户中所有全仓持仓及挂单的保证金折合成法币价值的净值

mgnRatio

string

维持保证金率

positionMgnRatio

string

仓位维持保证金比率

positionValue

string

仓位价值单位为USD

leverage

string

账户杠杆非负数

object[]

账户币种列表

GET/api/v3/account/assets

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

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1746687063471,
  "data": {
    "accountEquity": "11.13919278",
    "usdtEquity": "11.13921165",
    "btcEquity": "0.00011256",
    "unrealisedPnl": "0",
    "usdtUnrealisedPnl": "0",
    "btcUnrealizedPnl": "0",
    "effEquity": "6.19299777",
    "mmr": "0",
    "imr": "0",
    "mgnRatio": "0",
    "positionMgnRatio": "0",
    "positionValue": "0",
    "leverage": "1",
    "assets": [
      {
        "coin": "USDT",
        "equity": "6.19300826",
        "usdValue": "6.19299777",
        "balance": "6.19300826",
        "available": "6.19300826",
        "debt": "0",
        "locked": "0",
        "bonus": "10"
      },
      {
        "coin": "BGB",
        "equity": "1.15582129",
        "usdValue": "4.94618029",
        "balance": "1.15582129",
        "available": "1.15582129",
        "debt": "0",
        "locked": "0",
        "bonus": "0"
      }
    ]
  }
}

json

application/json

获取资金账户资产

GET

https://api.bitget.com

/api/v3/account/funding-assets

限频规则: 20次/秒/UID

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

获取资金账户信息，仅返回有资产的币种。

注：Pre-IPO 类型币种的 coin 字段大小写混用，如 preSPAX，请注意大小写，以获取币种信息接口里返回的 coin 为准

获取资金账户资产 › Request Parameters

coin

string

币种名称

获取资金账户资产 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

coin

string

币种名称

balance

string

总余额单位为当前资产币种

available

string

可用单位为当前资产币种

frozen

string

冻结单位为当前资产币种

获取财务记录

GET

https://api.bitget.com

/api/v3/account/financial-records

限频规则: 20次/秒/UID

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

获取账户90天内流水信息

获取财务记录 › Request Parameters

category

string · required

产品类型 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约 OTHER 其它

coin

string

币种例如，BTC

type

string

账户流水类型 TRANSFER_IN/TRANSFER_OUT...... 详细枚举可以在枚举页面获取

startTime

string

开始时间戳 Unix时间戳的毫秒数格式，如 1597026383085 最大查询范围90天

endTime

string

结束时间戳 Unix时间戳的毫秒数格式，如 1597026383085 startTime和endTime间隔不超过30天

limit

string

查询条数最大100，默认100

cursor

string

分页游标用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回cursor

获取财务记录 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

账务流水列表

cursor

string

分页游标

获取资金账户财务流水

GET

https://api.bitget.com

/api/v3/account/funding-financial-records

限频规则: 10次/秒/UID

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

获取资金账户财务流水，最大查询范围90天

获取资金账户财务流水 › Request Parameters

coin

string

币种
例如，BTC

type

string

账户流水类型
TRANSFER_IN/TRANSFER_OUT......
详细枚举可以在枚举页面获取

startTime

string

开始时间戳
Unix时间戳的毫秒数格式，如 1597026383085
最大查询范围90天

endTime

string

结束时间戳
Unix时间戳的毫秒数格式，如 1597026383085
startTime和endTime间隔不超过30天

limit

string

查询条数最大100，默认100

cursor

string

分页游标
用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回cursor

获取资金账户财务流水 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

账务流水列表

cursor

string

分页游标

获取交易手续费

GET

https://api.bitget.com

/api/v3/account/fee-rate

限频规则: 3次/秒/UID

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

获取交易手续费

获取交易手续费 › Request Parameters

symbol

string · required

交易对名称如BTCUSDT

category

string · required

业务线 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

获取交易手续费 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

makerFeeRate

string

挂单手续费率小数形式，即0.0002代表万分之二

takerFeeRate

string

吃单手续费率小数形式，即0.0002代表万分之二

获取最大可转出

GET

https://api.bitget.com

/api/v3/account/max-transferable

限频规则: 3次/秒/UID

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

获取统一账户最大可转出

获取最大可转出 › Request Parameters

coin

string · required

币种名称

获取最大可转出 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

coin

string

币种名称

maxTransfer

string

最大可转出单位为coin

borrowMaxTransfer

string

借币最大可转出单位为coin

获取最大可提币数量

GET

https://api.bitget.com

/api/v3/account/max-withdrawal

限频规则: 10次/秒/UID

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

注意：返回结果为实时计算值，存在毫秒级延迟；实际提币时平台仍会进行二次校验，该接口结果仅供参考。

获取最大可提币数量 › Request Parameters

coin

string · required

币种名称，如 USDT

获取最大可提币数量 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

coin

string

币种名称

otcMaxWithdrawal

string

OTC账户最大可提币数量

spotMaxWithdrawal

string

现货账户最大可提币数量

utaMaxWithdrawal

string

统一账户最大可提币数量

totalMaxWithdrawal

string

全部最大可提币数量

设置抵押品模式

POST

https://api.bitget.com

/api/v3/account/set-collateral-type

限频规则: 2次/秒/UID

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

设置当前统一账户的抵押品模式。

设置抵押品模式 › Request Parameters

collateralType

string · required

抵押品模式 mainstream 主流币 all 全部币种 custom 自定义

collateralCoins

string

抵押品币种名称支持多个币种，使用英文逗号分隔自定义模式 collateralType=custom 必填

设置抵押品模式 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

获取抵押品模式

GET

https://api.bitget.com

/api/v3/account/collateral-type

限频规则: 10次/秒/UID

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

获取抵押品模式 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

collateralType

string

抵押品模式 mainstream 主流币 all 全部币种 custom 自定义

collateralCoins

string

抵押品币种仅 collateralType=custom 自定义模式返回，多个币种之间使用英文逗号分隔

获取自定义抵押品支持币种

GET

https://api.bitget.com

/api/v3/account/custom-collateral-coins

限频规则: 10次/秒/IP

查询系统支持作为自定义抵押品的所有币种。该接口为公共接口，返回平台层支持的完整列表，与用户个人配置无关。

获取自定义抵押品支持币种 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

collateralCoin

string

抵押品币种名称

账户设置