Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Market
    Market Data
      Get InstrumentsgetGet RPI SymbolsgetGet TickersgetGet Order BookgetGet RPI Order BookgetGet Recent Public FillsgetGet Kline/CandlestickgetGet Kline/Candlestick Historyget
    Derivatives & Funding Rate
      Get Open Interest (OI)getGet Liquidations HistorygetGet Current Funding RategetGet Funding Rate HistorygetGet Index Price Componentsget
    Public Config
      Get Proof Of ReservesgetGet Market Maker Score WeightgetGet Institution Fee GroupgetGet Cash Dividend RecordsgetGet Split Recordsget
    Trading & Risk Rules
      Get Risk Reserve(Daily)getGet Risk Reserve(Hourly)getGet Risk Reserve AllgetGet Margin LoangetGet Position TiergetGet Open Interest LimitgetGet Discount Rateget
    Trading Statistics
      Get Spot Whale Net Flow DatagetGet Spot Fund Flow DatagetGet Spot 24H Net Capital Inflow DatagetGet Margin Long Short Ratio DatagetGet Margin Loan Growth Rate DatagetGet Isolated Margin Borrowing Ratio DatagetGet Futures Active Buy Sell Volume DatagetGet Futures Long Short Ratio DatagetGet Futures Active Long Short Position DatagetGet Futures Active Long Short Account Dataget
Market
Market

Trading & Risk Rules

Trading & Risk Rules


Get Risk Reserve(Daily)

GET
https://api.bitget.com
/api/v3/market/risk-reserve

Rate limit: 20/sec/IP

Query risk reserve records.

Get Risk Reserve(Daily) › Request Parameters

category
​string · required

Product type USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures

symbol
​string · required

Symbol name, e.g. BTCUSDT

marginCoin
​string

Margin coin, It is required when the category is COIN-FUTURES

Get Risk Reserve(Daily) › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
totalBalance
​string

Total balance of the risk reserve fund (Deprecated)

coin
​string

Settlement coin

​object[]

Risk reserve records

GET/api/v3/market/risk-reserve
curl 'https://api.bitget.com/api/v3/market/risk-reserve?category=<string>&symbol=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1753793743942, "data": { "totalBalance": "", "coin": "USDT", "riskReserveRecords": [ { "type": "", "amount": "9.8470265278770000", "balance": "95815.6773460800020000", "ts": "1753718400000" }, { "type": "", "amount": "0.4328615782800000", "balance": "95805.8303195521250000", "ts": "1753632000000" } ] } }
json
application/json

Get Risk Reserve(Hourly)

GET
https://api.bitget.com
/api/v3/market/risk-reserve-hour

Rate limit: 20/sec/IP

Query risk reserve records.

Get Risk Reserve(Hourly) › Request Parameters

category
​string · required

Product type USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures

symbol
​string · required

Symbol name, e.g. BTCUSDT

marginCoin
​string

Margin coin, It is required when the category is COIN-FUTURES

Get Risk Reserve(Hourly) › Response Parameters

200

Successful response

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

Settlement coin

​object[]

Risk reserve records

GET/api/v3/market/risk-reserve-hour
curl 'https://api.bitget.com/api/v3/market/risk-reserve-hour?category=<string>&symbol=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1753793743942, "data": { "coin": "USDT", "riskReserveRecords": [ { "amount": "9.8470265278770000", "balance": "95815.6773460800020000", "ts": "1753718400000" }, { "amount": "0.4328615782800000", "balance": "95805.8303195521250000", "ts": "1753632000000" } ] } }
json
application/json

Get Risk Reserve All

GET
https://api.bitget.com
/api/v3/market/risk-reserve-all

Rate limit: 3/sec/IP

Get all current insurance funds.

Independent insurance pool data is refreshed every 1 minute, while the aggregate insurance pool data is refreshed every 1 hour.

Get Risk Reserve All › Request Parameters

category
​string · required

Product type USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures

Get Risk Reserve All › Response Parameters

200

Successful response

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

Insurance fund list

GET/api/v3/market/risk-reserve-all
curl 'https://api.bitget.com/api/v3/market/risk-reserve-all?category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1753793743942, "data": { "list": [ { "symbols": [ "BTCUSDT" ], "coin": "USDT", "balance": "95815.6773460800020000" } ] } }
json
application/json

Get Margin Loan

GET
https://api.bitget.com
/api/v3/market/margin-loans

Rate limit: 20/sec/IP

Query interest rates for margin loans.

Get Margin Loan › Request Parameters

coin
​string · required

Coin name, e.g. BTC

level
​string

User level
vip0/vip1/vip2/vip3/vip4/vip5/vip6/vip7
pro1/pro2/pro3/pro4/pro5/pro6
Default: vip0

Get Margin Loan › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
dailyInterest
​string

Daily interest rate

annualInterest
​string

Annual interest rate

limit
​string

Loan limit

masterSubLimit
​string

Master/sub account limit

platformRemaingQuota
​string

Platform remaining quota

GET/api/v3/market/margin-loans
curl 'https://api.bitget.com/api/v3/market/margin-loans?coin=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730912814587, "data": { "dailyInterest": "0.1", "annualInterest": "0.00416667", "limit": "3000", "masterSubLimit": "1000", "platformRemaingQuota": "500000" } }
json
application/json

Get Position Tier

GET
https://api.bitget.com
/api/v3/market/position-tier

Rate limit: 20/sec/IP

Query the position tier info.

Get Position Tier › Request Parameters

category
​string · required

Product type MARGIN Margin trading USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures

symbol
​string

Symbol name, e.g. BTCUSDT, applies to Futures

coin
​string

Coin name, e.g. BTC, applies to Margin

Get Position Tier › Response Parameters

200

Successful response

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

Position tier

leverage
​string

Leverage

minTierValue
​string

Minimum value of current tier Available only for futures

maxTierValue
​string

Maximum value of current tier Available only for futures

mmr
​string

Maintenance margin ratio When the margin rate of the position falls below the maintenance margin rate, forced liquidation or position reduction will be triggered

GET/api/v3/market/position-tier
curl 'https://api.bitget.com/api/v3/market/position-tier?category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1731146663643, "data": [ { "tier": "1", "minTierValue": "0", "maxTierValue": "100000", "leverage": "125", "mmr": "0.004" } ] }
json
application/json

Get Open Interest Limit

GET
https://api.bitget.com
/api/v3/market/oi-limit

Rate limit: 10/sec/IP

Interface is used to get future contract OI Limit.

Get Open Interest Limit › Request Parameters

category
​string · required

Product type USDT-FUTURES USDT-M Futures COIN-FUTURES Coin-M Futures USDC-FUTURES USDC-M Futures

symbol
​string

Trading pair, based on the symbolName, i.e. BTCUSDT

Get Open Interest Limit › Response Parameters

200

Successful response

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

Product name

notionalValue
​string

Individual User Position Notional Value

totalNotionalValue
​string

Sub-account and Main-account Position Notional Value

GET/api/v3/market/oi-limit
curl 'https://api.bitget.com/api/v3/market/oi-limit?category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1741665165571, "data": [ { "symbol": "BTCUSDT", "notionalValue": "1000000", "totalNotionalValue": "5000000" }, { "symbol": "ETHUSDT", "notionalValue": "1000000", "totalNotionalValue": "5000000" } ] }
json
application/json

Get Discount Rate

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

Rate limit: 20/sec/IP

Query discount rate applied to margin loans.

Get Discount Rate › Response Parameters

200

Successful response

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

Coin name, e.g. BTC

​object[]

List

GET/api/v3/market/discount-rate
curl https://api.bitget.com/api/v3/market/discount-rate
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730911874605, "data": [ { "coin": "ETH", "list": [ { "tierStartValue": "0", "discountRate": "0.99" }, { "tierStartValue": "40000", "discountRate": "0.98" } ] } ] }
json
application/json

Public ConfigTrading Statistics