如何使用幣安統一帳戶專業版計畫 API

欄位

說明

uniMMR

統一維持保證金比率

accountEquity

統一保證金帳戶淨值，以美元計

actualEquity

美元計價統一保證金帳戶實際淨值 (未計入質押率

accountMaintMargin

統一維持保證金、開倉和貸款的必要保證金，以美元計

accountStatus

統一保證金帳戶目前狀態："NORMAL", "MARGIN_CALL", "SUPPLY_MARGIN", "REDUCE_ONLY", "ACTIVE_LIQUIDATION", "FORCE_LIQUIDATION", "BANKRUPTED"

名稱

帳戶類別

必填

recvWindow

多頭

否

timestamp

多頭

是

回應類型

回應內容

一般回應

{

"uniMMR": "1.87987800",

"accountEquity": "122607.35137903",

"actualEquity": "142607.35137903",

"accountMaintMargin": "23.72469206",

"accountStatus": "NORMAL"

}

帳戶未啟用統一帳戶專業版計畫時

{

"code":-21001,

"msg": "invalid request: request ID is not a Portfolio Margin Account"

}

欄位

說明

asset

預設貸款資產 (USDT)

amount

USDT 計價統一帳戶專業版破產貸款金額

名稱

帳戶類別

必填

recvWindow

多頭

否

timestamp

多頭

是

回應類型

回應內容

一般回應

{

"asset": "USDT",

"amount": "579.45",

}

用戶沒有任何統一帳戶專業版破產貸款

{

"error code": -21004,

"msg":"No outstanding pmLoan"

}

名稱

帳戶類別

必填

recvWindow

多頭

否

timestamp

多頭

是

回應類型

回應內容

一般回應

{

"tranId": 58203331886213504

}

用戶的現貨錢包 USDT 餘額不足，無法償還統一帳戶專業版破產貸款

{

"error code": -21005,

"msg":"No enough USDT to repay pmLoan"

}

用戶的統一帳戶專業版破產貸款還款正在處理中

{

"error code": -21006,

"msg":"Had pmLoan repayment in process"

}

由於強行平倉處理中，因此用戶無法償還統一帳戶專業版破產貸款

{

"error code": -21007,

"msg":"Post fail since liquidation is in process"

}

欄位

說明

asset

抵押品資產類型

collateralRate

相應質押率

回應類型

回應內容

一般回應

{

"asset": "USDT",

"collateralRate": "1.0000",

}

客戶狀態

回應內容

用戶將資產從保證金錢包轉至合約錢包

/sapi/v1/asset/transfer:

{

"error code": -21002,

"msg":"Portfolio Margin Account doesn't support transfer from margin to futures”

}

保證金資產無法及時取回

/sapi/v1/margin/maxTransferable

/sapi/v1/asset/transfer

/sapi/v1/margin/transfer

/sapi/v1/future/transfer

{

"error code": -21003,

"msg":"fail to retrieve margin assets”

}

系統未能及時更新保證金資產

/sapi/v1/margin/maxBorrowable/sapi/v1/margin/loan

/sapi/v1/margin/order with MARGIN_BUY

{

"error code": -21003,

"msg":"fail to retrieve margin assets”

}

欄位

說明

maxWithdrawAmountUSD

美元計價的統一帳戶專業版可轉出金額上限 (依預估匯率計算)*

maxWithdrawAmount

統一帳戶專業版可以轉出的金額上限*

名稱

帳戶類別

必填

asset

STRING

是

recvWindow

多頭

否

回應類型

回應內容

一般回應

{

"maxWithdrawAmountUSD": "25347.92083245", // Classic Portfolio Margin maximum virtual amount for transfer out in USD

"asset": "BTC", // asset name

"maxWithdrawAmount": "1.33663654", // maximum amount for transfer out

}

名稱

帳戶類別

必填

asset

STRING

否

startTime

多頭

否

endTime

多頭

否

size

多頭

預設：10 上限：100

recvWindow

多頭

否

timestamp

多頭

是

回應類型

回應內容

一般回應

[

{

"asset": "USDT",

"interest": "0.00000604",

"principal": "0.04902887",

"interestRate": "0.00012329",

"type": "UM_NEGATIVE_BALANCE",

"interestAccruedTime": 1678924800000

}

]

名稱

帳戶類別

必填

asset

STRING

否

recvWindow

多頭

否

timestamp

多頭

是

回應類型

回應內容

一般回應

[

{

"asset": "USDT",

"dailyInterest": "0.00012329", //daily interest rate

"yearlyInterest": "0.045" //annual interest rate

}

]

}

Name

Type

Mandatory

recvWindow

LONG

NO

timestamp

LONG

YES

Response Type

Response Content

Normal Response

{

"asset": "USDT",

"collateralInfo": [

{

"tierFloor": "0",

"tierCap": "30000000",

"collateralRate": "1"

},

{

"tierFloor": "30000000",

"tierCap": "99999999999",

"collateralRate": "0.95"

}

],

"asset":"BNB",

"collateralInfo": [

{

"tierFloor": "0",

"tierCap": "2000000",

"collateralRate": "1"

},

{

"tierFloor": "2000000",

"tierCap": "4000000",

"collateralRate": "0.95"

},

{

"tierFloor": "4000000",

"tierCap": "99999999999",

"collateralRate": "0.90"

}

]

}