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

Trading Risk & Position Config

Trading Risk & Position Config


Get OI Limit

GET
https://api.bitget.com
/api/v3/account/open-interest-limit

Rate limit: 5/sec/UID

Get open interest limit.

Get OI Limit › Request Parameters

symbol
​string · required

Symbol

e.g.,BTCUSDT

category
​string · required

Product type

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

Get OI Limit › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
symbol
​string

Symbol name

singleUserLimit
​string

Single User Limit Quantity.

masterSubLimit
​string

Main/Sub-account Quantity Limit

marketMakerLimit
​string

Market Maker Total Quota

GET/api/v3/account/open-interest-limit
curl 'https://api.bitget.com/api/v3/account/open-interest-limit?symbol=<string>&category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1764170997805, "data": { "symbol": "BTCUSDT", "singleUserLimit": "2766.30748", "masterSubLimit": "9173.8782", "marketMakerLimit": "0" } }
json
application/json

Get All Symbol Fee Rates

GET
https://api.bitget.com
/api/v3/account/all-fee-rate

Rate limit: 3/sec/UID

Permission: UTA mgt. (read)

Query fee rates for all trading pairs under a specified product type.

  • Only category provided (no symbol): Returns fee rates for all symbols under that product type
  • Only symbol provided (no category): Returns an error
  • Both category and symbol provided: Returns the fee rate for the specified symbol. If category and symbol do not match, symbol takes priority
  • Neither provided: Returns an error

Get All Symbol Fee Rates › Request Parameters

category
​string · required

Product type

SPOT Spot trading

MARGIN Margin trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol
​string

Symbol name

e.g.,BTCUSDT

Get All Symbol Fee Rates › Response Parameters

200

Successful response

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

Symbol name

makerFeeRate
​string

Maker fee rate

In decimal form, e.g., 0.0002 represents 0.02%

takerFeeRate
​string

Taker fee rate

In decimal form, e.g., 0.0002 represents 0.02%

GET/api/v3/account/all-fee-rate
curl 'https://api.bitget.com/api/v3/account/all-fee-rate?category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1751972326323, "data": [ { "symbol": "BTCUSDT", "makerFeeRate": "0.0008", "takerFeeRate": "0.0008" } ] }
json
application/json

Get Eligible Symbols

GET
https://api.bitget.com
/api/v3/account/eligible-symbols

Rate limit: 10/sec/UID

Permission: UTA mgt. (read)

Query all margin trading pairs available to the eligible (whitelist) user.

Get Eligible Symbols › Request Parameters

symbol
​string

Symbol name

e.g., BTCUSDT

Get Eligible Symbols › Response Parameters

200

Successful response

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

Symbol name

category
​string

Product type

MARGIN Margin trading

baseCoin
​string

Base coin

e.g., BTC in BTCUSDT

quoteCoin
​string

Quote coin

e.g., USDT in BTCUSDT

symbolType
​string

Symbol type

crypto Cryptocurrency

metal Precious metals

stock Stocks

commodity Commodities

buyLimitPriceRatio
​string

Buy price limit ratio

The ratio of the buy limit price to the market price, determining the maximum price at which a buy order will be placed

sellLimitPriceRatio
​string

Sell price limit ratio

The ratio of the sell limit price to the market price, determining the minimum price at which a sell order will be placed

minOrderQty
​string

Minimum order quantity

The smallest allowable quantity for placing an order in terms of the base coin

maxOrderQty
​string

Maximum order quantity for a single limit order

The largest allowable quantity for placing an order in terms of the base coin

A value of 0 indicates no limit

pricePrecision
​string

Price precision

The number of decimal places allowed for the price

quantityPrecision
​string

Quantity precision

The number of decimal places allowed for the quantity

quotePrecision
​string

Market order precision

The number of decimal places allowed for the price of the quote coin

minOrderAmount
​string

Minimum order amount

The smallest allowable amount for placing an order in terms of the quote coin

maxSymbolOrderNum
​string

Maximum order number in terms of the trading pair

maxProductOrderNum
​string

Maximum order number in terms of the product line

status
​string

Trading pair status

listed Listed (not yet open)

online Normal

limit_open Restrict opening positions

limit_close Restrict closing positions

offline Delisted/under maintenance

restrictedAPI API restricted

maintainTime
​string

Maintenance time

If not configured, it returns: ""

areaSymbol
​string

Area symbol

yes / no

maxPositionNum
​string

Maximum position number in terms of the trading pair

isReality
​string

Reality identifier

yes Reality stock token

no Non-Reality stock token

launchTime
​string

Launch time

Unix millisecond timestamp indicating when the trading pair was launched

GET/api/v3/account/eligible-symbols
curl https://api.bitget.com/api/v3/account/eligible-symbols
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1784618341109, "data": [ { "symbol": "RPBRUSDT", "category": "MARGIN", "baseCoin": "rPBR", "quoteCoin": "USDT", "symbolType": "stock", "buyLimitPriceRatio": "0.1", "sellLimitPriceRatio": "0.1", "minOrderQty": "0.0001", "maxOrderQty": "0", "pricePrecision": "2", "quantityPrecision": "4", "quotePrecision": "6", "minOrderAmount": "20", "maxSymbolOrderNum": "", "maxProductOrderNum": "400", "status": "online", "maintainTime": "", "areaSymbol": "yes", "maxPositionNum": "200", "isReality": "yes", "launchTime": "1781101641926" } ] }
json
application/json

Get Eligible Margin Tier

GET
https://api.bitget.com
/api/v3/account/eligible-margin-tier

Rate limit: 10/sec/UID

Permission: UTA mgt. (read)

Query margin leverage tier information based on the user's whitelist eligibility.

Get Eligible Margin Tier › Request Parameters

coin
​string

Coin name

e.g., BTC

Get Eligible Margin Tier › Response Parameters

200

Successful response

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

Coin name

​object[]

Tier list

GET/api/v3/account/eligible-margin-tier
curl https://api.bitget.com/api/v3/account/eligible-margin-tier
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1784618341109, "data": [ { "coin": "BTC", "tiers": [ { "tier": "1", "minTierValue": "0", "maxTierValue": "50000", "leverage": "10", "mmr": "0.05" } ] } ] }
json
application/json

Get Eligible Loan Info

GET
https://api.bitget.com
/api/v3/account/eligible-loan-info

Rate limit: 10/sec/UID

Permission: UTA mgt. (read)

Query margin loan information based on the user's whitelist eligibility.

Get Eligible Loan Info › Request Parameters

coin
​string

Coin name

e.g., BTC

Get Eligible Loan Info › Response Parameters

200

Successful response

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

Single UID loan limit

masterSubLimit
​string

Master and sub-account loan limit

platformRemaingQuota
​string

Platform remaining quota

GET/api/v3/account/eligible-loan-info
curl https://api.bitget.com/api/v3/account/eligible-loan-info
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1784618341109, "data": [ { "limit": "100000", "masterSubLimit": "500000", "platformRemaingQuota": "10000000" } ] }
json
application/json

Get Eligible Discount Rate

GET
https://api.bitget.com
/api/v3/account/eligible-discount-rate

Rate limit: 20/sec/UID

Permission: UTA mgt. (read)

Query the coin discount rate gradient based on the user's whitelist eligibility.

Get Eligible Discount Rate › Request Parameters

coin
​string

Coin name

e.g., BTC

Get Eligible Discount Rate › Response Parameters

200

Successful response

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

Coin name

​object[]

List

GET/api/v3/account/eligible-discount-rate
curl https://api.bitget.com/api/v3/account/eligible-discount-rate
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730911874605, "data": [ { "coin": "BTC", "list": [ { "tierStartValue": "0", "discountRate": "0.85" }, { "tierStartValue": "10000", "discountRate": "0.70" }, { "tierStartValue": "20000", "discountRate": "0.50" } ] } ] }
json
application/json

Margin & Borrow/RepaySub Accounts