Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
账户
    资产与余额
      获取账户资产get获取资金账户资产get获取财务记录get获取资金账户财务流水get获取交易手续费get获取最大可转出get获取最大可提币数量get设置抵押品模式post获取抵押品模式get获取自定义抵押品支持币种get
    账户设置
      获取账户信息get获取账户设置get预设置调整杠杆get调整杠杆post调整持仓模式post设置BGB抵扣post获取BGB抵扣状态get账户切换post获取切换状态get调整保证金post获取Delta模式信息get账户模式切换post
    杠杆与借贷管理
      获取可还币种get获取支付币种get还款post获取兑换记录get
    交易风控与仓位设置
      获取OI限仓get获取业务线所有交易对手续费get获取准入用户杠杆交易对get获取准入用户杠杆梯度档位get获取准入用户借币数据get获取准入用户币种折扣率梯度get
    子账户
      新建子账户post冻结/解冻子账户post查询子账户列表get查询子账户统一账户资产get新建子账户API Keypost修改子账户API Keypost删除子账户API Keypost查询子账户API Key列表get创建 Agent 子账户post
    充值提币划转
      设置充值账户post获取充值地址get获取子账户充值地址get获取充值记录get获取子账户充值记录get提币post撤销提币post获取提币记录get查询提币地址簿get获取可划转币种get划转post子母划转post获取子母划转记录get子账户主动划转至母账户post
    小额资产兑换
      获取小额兑换历史记录get获取小额兑换可兑换币种get执行小额兑换post
    机构限频
      获取限频配额get设置限频配额post
账户
账户

杠杆与借贷管理

杠杆与借贷管理


获取可还币种

GET
https://api.bitget.com
/api/v3/account/repayable-coins

限频规则: 10次/秒/UID

获取可还款币种及可还数量信息

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

获取可还币种 › Response Parameters

200

Successful response

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

可还币种列表

maxSelection
​string

最大可选取币种数量

GET/api/v3/account/repayable-coins
curl https://api.bitget.com/api/v3/account/repayable-coins
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730189435812, "data": { "repayableCoinList": [ { "coin": "USDT", "size": "147214.04781004", "amount": "147102.60677584" } ], "maxSelection": "1" } }
json
application/json

获取支付币种

GET
https://api.bitget.com
/api/v3/account/payment-coins

限频规则: 10次/秒/UID

获取支付币种及可支付数量信息

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

获取支付币种 › Response Parameters

200

Successful response

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

支付币种列表

maxSelection
​string

最大可选取币种数量

GET/api/v3/account/payment-coins
curl https://api.bitget.com/api/v3/account/payment-coins
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730189435812, "data": { "paymentCoinList": [ { "coin": "ETH", "size": "0.12", "amount": "293.5" } ], "maxSelection": "1" } }
json
application/json

还款

POST
https://api.bitget.com
/api/v3/account/repay

限频规则: 5次/秒/UID

支持通过可还币种兑换待还币种的还款操作

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

还款 › Request Parameters

repayableCoinList
​string[] · required

可还币种列表

paymentCoinList
​string[] · required

支付币种列表

还款 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
result
​string

还款结果 YES/NO

repayAmount
​string

还款金额

POST/api/v3/account/repay
curl https://api.bitget.com/api/v3/account/repay \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "repayableCoinList": [ "USDT" ], "paymentCoinList": [ "ETH" ] }'
Example Request Body
{ "repayableCoinList": [ "USDT" ], "paymentCoinList": [ "ETH" ] }
json
application/json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1728625799912, "data": { "result": "YES", "repayAmount": "4345" } }
json
application/json

获取兑换记录

GET
https://api.bitget.com
/api/v3/account/convert-records

限频规则: 20次/秒/UID

获取最近90天兑换记录

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

获取兑换记录 › Request Parameters

fromCoin
​string

兑换币种 eg: USDT 它指的是被转换的币种

toCoin
​string

目标币种 eg: BTC 它指的是被转换成的(接收的)币种

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/api/v3/account/convert-records
curl https://api.bitget.com/api/v3/account/convert-records
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730369634178, "data": { "list": [ { "fromCoin": "USDT", "fromCoinSize": "281.72276656", "toCoin": "ETH", "toCoinSize": "0.0986029682", "price": "0.0003499", "ts": "1730359119358" }, { "fromCoin": "USDT", "fromCoinSize": "3305.13434913", "toCoin": "ETH", "toCoinSize": "1.1567970221", "price": "0.00035", "ts": "1730359063138" } ], "cursor": "1235780967957364737" } }
json
application/json

账户设置交易风控与仓位设置