Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Account
    Assets & Balance
      Get Account AssetsgetGet Account Funding AssetsgetGet Financial RecordsgetGet Funding Financial RecordsgetGet Account Fee RategetGet Max TransferablegetGet Max WithdrawalgetSet Collateral TypepostGet Collateral TypegetGet Custom Collateral Coinsget
    Account Settings
      Get Account InfogetGet Account SettinggetPre Set LeveragegetSet LeveragepostSet Holding ModepostSwitch DeductpostGet Deduct InfogetSwitch AccountpostGet Switch StatusgetSet MarginpostGet Delta InfogetAdjust Account Modepost
    Margin & Borrow/Repay
      Get Repayable CoinsgetGet Payment CoinsgetRepaypostGet Convert Recordsget
    Trading Risk & Position Config
      Get OI LimitgetGet All Symbol Fee RatesgetGet Eligible SymbolsgetGet Eligible Margin TiergetGet Eligible Loan InfogetGet Eligible Discount Rateget
    Sub Accounts
      Create Sub-accountpostFreeze/Unfreeze Sub-accountpostGet Sub-account ListgetGet Sub-account Unified AssetsgetCreate Sub-account API KeypostModify Sub-account API KeypostDelete Sub-account API KeypostGet Sub-account API KeysgetCreate Agent Sub-accountpost
    Deposit/Withdrawal & Transfer
      Set Up Deposit AccountpostGet Deposit AddressgetGet Sub Deposit AddressgetGet Deposit RecordsgetGet Sub Deposit RecordsgetWithdrawalpostCancel WithdrawalpostGet Withdrawal RecordsgetGet Withdraw Address BookgetGet Transferable CoinsgetTransferpostMain-Sub Account TransferpostGet Main-Sub Account Transfer RecordsgetSub-Main Account Transferpost
    Small Assets Convert
      Get Small Assets HistorygetGet Small AssetsgetSmall Assets Tradepost
    Institutional Rate Limit
      Get RateLimit QuotagetSet RateLimit Quotapost
Account
Account

Margin & Borrow/Repay

Margin & Borrow/Repay


Get Repayable Coins

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

Rate limit: 10/sec/UID

Query repayable coins.

Permission: UTA mgt. (read)

Get Repayable Coins › Response Parameters

200

Successful response

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

Repayable coin list

maxSelection
​string

Maximum number of coins that can be selected for repayment

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 Payment Coins

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

Rate limit: 10/sec/UID

Query payment coins.

Permission: UTA mgt. (read)

Get Payment Coins › Response Parameters

200

Successful response

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

Payment coin list

maxSelection
​string

Maximum number of coins that can be selected for repayment

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

Repay

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

Rate limit: 5/sec/UID

This endpoint enables manual repayment in the Unified Trading Account.

Permission: UTA mgt. (read & write)

Repay › Request Parameters

repayableCoinList
​string[] · required

Repayable coin list

paymentCoinList
​string[] · required

Payment coin list

Repay › Response Parameters

200

Successful response

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

Repayment result YES/NO

repayAmount
​string

Repayment amount

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 Convert Records

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

Rate limit: 20/sec/UID

Query convert records within the last 90 days.

Permission: UTA mgt. (read)

Get Convert Records › Request Parameters

fromCoin
​string

From coin (source coin) It refers to the coin being converted

toCoin
​string

To coin (target coin) It refers to the coin being converted into (received)

startTime
​string

Start timestamp A Unix timestamp in milliseconds e.g.,1597026383085 The access window is 90 days

endTime
​string

End timestamp A Unix timestamp in milliseconds e.g.,1597026383185 The time range between startTime and endTime must not exceed 30 days

limit
​string

Limit per page Default:100. Maximum:100

cursor
​string

Cursor Pagination is implemented by omitting the cursor in the first query and applying the cursor from the previous query for subsequent pages

Get Convert Records › Response Parameters

200

Successful response

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

List

cursor
​string

Cursor

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

Account SettingsTrading Risk & Position Config