Trading & Risk Rules
Trading & Risk Rules
Get Risk Reserve(Daily)
Rate limit: 20/sec/IP
Query risk reserve data for the last 30 days (daily granularity).
Request Parameters
categoryProduct type
USDT-FUTURES USDT futures
COIN-FUTURES Coin-M futures
USDC-FUTURES USDC futures
symbolSymbol name, e.g. BTCUSDT
marginCoinMargin coin, It is required when the category is COIN-FUTURES
Get Risk Reserve(Daily) › Response Parameters
Successful response
codemsgrequestTimetotalBalanceTotal balance of the risk reserve fund (Deprecated)
coinSettlement coin
Risk reserve records
Get Risk Reserve(Hourly)
Rate limit: 20/sec/IP
Query risk reserve data for the last 30 hours (hourly granularity).
Request Parameters
categoryProduct type
USDT-FUTURES USDT futures
COIN-FUTURES Coin-M futures
USDC-FUTURES USDC futures
symbolSymbol name, e.g. BTCUSDT
marginCoinMargin coin, It is required when the category is COIN-FUTURES
Get Risk Reserve(Hourly) › Response Parameters
Successful response
codemsgrequestTimecoinSettlement coin
Risk reserve records
Get 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.
Request Parameters
categoryProduct type
USDT-FUTURES USDT futures
COIN-FUTURES Coin-M futures
USDC-FUTURES USDC futures
Get Risk Reserve All › Response Parameters
Successful response
codemsgrequestTimeInsurance fund list
Get Margin Loan
Rate limit: 20/sec/IP
Query interest rates for margin loans.
Request Parameters
coinCoin name, e.g. BTC
levelUser levelvip0/vip1/vip2/vip3/vip4/vip5/vip6/vip7pro1/pro2/pro3/pro4/pro5/pro6
Default: vip0
Get Margin Loan › Response Parameters
Successful response
codemsgrequestTimedailyInterestDaily interest rate
annualInterestAnnual interest rate
limitLoan limit
masterSubLimitMaster/sub account limit
platformRemaingQuotaPlatform remaining quota
Get All Margin Loans
Rate limit: 20/sec/IP
Query the margin loan information of all coins. When coin is not provided, the information of all supported coins is returned.
Request Parameters
coinCoin name, e.g. BTC
If not provided, the information of all supported coins is returned
levelUser levelvip0/vip1/vip2/vip3/vip4/vip5/vip6/vip7pro1/pro2/pro3/pro4/pro5/pro6
Default: vip0
Get All Margin Loans › Response Parameters
Successful response
codemsgrequestTimecoinCoin name
dailyInterestDaily interest rate
annualInterestAnnual interest rate
limitLoan limit
masterSubLimitMaster/sub account limit
platformRemaingQuotaPlatform remaining quota
Get Interest Rate History
Query the historical margin borrowing interest rate for a specified coin and VIP tier. Used for backtesting borrowing costs, reconciling historical position interest, or estimating the interest savings from a VIP tier upgrade.
Data granularity is fixed at 1 hour, with the most recent 1 month retained.
-
Rate limit: 10/sec/UID
-
Permission: UTA mgt. (read)
Request Parameters
coinCoin name, e.g. USDT
Only coins with margin borrowing enabled are supported; an unsupported coin returns an error
startTimeStart time, a Unix millisecond timestamp
Only data from the most recent 1 month is supported
endTimeEnd time, a Unix millisecond timestamp
Must not be more than 30 days apart from startTime
If no time parameters are provided, returns the most recent limit entries counting back from now
levelUser tier
vip0/vip1/vip2/vip3/vip4/vip5/vip6/vip7
pro1/pro2/pro3/pro4/pro5/pro6
Default: vip0
limitNumber of entries per page
Default: 10. Maximum: 500
cursorPagination cursor
Pass the cursor from the previous page's response
Get Interest Rate History › Response Parameters
Successful response
codemsgrequestTimecursorCursor for the next page
Empty indicates there is no more data
Interest rate history data set
Get Position Tier
Rate limit: 20/sec/IP
Query the position tier info.
Request Parameters
categoryProduct type
MARGIN Margin trading
USDT-FUTURES USDT futures
COIN-FUTURES Coin-M futures
USDC-FUTURES USDC futures
symbolSymbol name, e.g. BTCUSDT, applies to Futures
coinCoin name, e.g. BTC, applies to Margin
Get Position Tier › Response Parameters
Successful response
codemsgrequestTimetierPosition tier
leverageLeverage
minTierValueMinimum value of current tier
Available only for futures
maxTierValueMaximum value of current tier
Available only for futures
mmrMaintenance margin ratio
When the margin rate of the position falls below the maintenance margin rate, forced liquidation or position reduction will be triggered
Get Open Interest Limit
Rate limit: 10/sec/IP
Interface is used to get future contract OI Limit.
Request Parameters
categoryProduct type
USDT-FUTURES USDT-M Futures
COIN-FUTURES Coin-M Futures
USDC-FUTURES USDC-M Futures
symbolTrading pair, based on the symbolName, i.e. BTCUSDT
Get Open Interest Limit › Response Parameters
Successful response
codemsgrequestTimesymbolProduct name
notionalValueIndividual User Position Notional Value
totalNotionalValueSub-account and Main-account Position Notional Value
singlePositionRatioSingle UID contract position ratio
Returned as a decimal, e.g. 0.1 represents 10%
totalPositionRatioMaster/sub-account contract position ratio
Returned as a decimal, e.g. 0.1 represents 10%