最後更新：2024 年 9 月 5 日
幣安統一帳戶專業版計畫可透過幣安合約 API 連結套組使用，並向所有已啟用幣安合約 API 交易介面的用戶開放。幣安統一帳戶專業版計畫之中，全倉槓桿、U 本位合約和幣本位合約市場上現有的交易 API 端點仍可使用，且與一般帳戶交易做法一致。
請注意，統一帳戶專業版 API 端點與幣安統一帳戶專業版相容，且無法在新統一帳戶使用 (除非特殊狀況)。請參照這篇文章了解統一帳戶專業版和新統一賬戶之間的區別。
若需新統一帳戶可用端點的完整清單，請參照幣安統一帳戶 API。
幣安統一帳戶專業版計畫 API 詳情
幣安統一帳戶專業版計畫除了幣安標準 API 端點以外，更新增專屬附加端點，提供下列輸出內容：
1. uniMMR、統一帳戶專業版狀態
2. 破產貸款記錄 (GET) 與還款 (POST)
3. 各幣種的質押率
4. 其他統一帳戶專業版計畫 API 例外
5. 統一帳戶專業版資訊 (USER_DATA)
6. 統一帳戶專業版利息記錄 (USER_DATA)
7. 統一帳戶專業版利率 (USER_DATA)
8. 各幣種的階梯質押率
9. 錯誤代碼
1. uniMMR 與統一帳戶專業版狀態
下列要求會回傳相對應的輸出內容：
欄位 | 說明 |
uniMMR | 統一維持保證金比率 |
accountEquity | 統一保證金帳戶淨值，以美元計 |
actualEquity | 美元計價統一保證金帳戶實際淨值 (未計入質押率 |
accountMaintMargin | 統一維持保證金、開倉和貸款的必要保證金，以美元計 |
accountStatus | 統一保證金帳戶目前狀態："NORMAL", "MARGIN_CALL", "SUPPLY_MARGIN", "REDUCE_ONLY", "ACTIVE_LIQUIDATION", "FORCE_LIQUIDATION", "BANKRUPTED" |
API 參數：
名稱 | 帳戶類別 | 必填 |
recvWindow | 多頭 | 否 |
timestamp | 多頭 | 是 |
API 回應：
回應類型 | 回應內容 |
一般回應 | { "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" } |
2. 統一帳戶專業版破產貸款
- 統一帳戶專業版破產貸款記錄
下列要求會回傳相對應的輸出內容：
欄位 | 說明 |
asset | 預設貸款資產 (USDT) |
amount | USDT 計價統一帳戶專業版破產貸款金額 |
API 參數：
名稱 | 帳戶類別 | 必填 |
recvWindow | 多頭 | 否 |
timestamp | 多頭 | 是 |
API 回應：
回應類型 | 回應內容 |
一般回應 | { "asset": "USDT", "amount": "579.45", } |
用戶沒有任何統一帳戶專業版破產貸款 | { "error code": -21004, "msg":"No outstanding pmLoan" } |
- 統一帳戶專業版破產貸款還款
API 參數：
名稱 | 帳戶類別 | 必填 |
recvWindow | 多頭 | 否 |
timestamp | 多頭 | 是 |
API 回應：
回應類型 | 回應內容 |
一般回應 | { "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" } |
3. 統一帳戶質押率 (MARKET_DATA)
* 該接口對於同一帳戶專業版用戶將與2024年9月11日失效
下列要求會回傳相對應的輸出內容：
欄位 | 說明 |
asset | 抵押品資產類型 |
collateralRate | 相應質押率 |
API 回應：
回應類型 | 回應內容 |
一般回應 | { "asset": "USDT", "collateralRate": "1.0000", } |
4. 其他統一帳戶專業版計畫 API 例外
客戶狀態 | 回應內容 |
用戶將資產從保證金錢包轉至合約錢包 | /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” } |
5. 統一帳戶專業版當前帳戶資訊
下列要求會回傳相對應的輸出內容：
欄位 | 說明 |
maxWithdrawAmountUSD | 美元計價的統一帳戶專業版可轉出金額上限 (依預估匯率計算)* |
maxWithdrawAmount | 統一帳戶專業版可以轉出的金額上限* |
*意即轉帳至用戶的現貨錢包
API 參數：
名稱 | 帳戶類別 | 必填 |
asset | STRING | 是 |
recvWindow | 多頭 | 否 |
API 回應：
回應類型 | 回應內容 |
一般回應 | { "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 } |
6. 統一帳戶專業版利息記錄 (USER_DATA)
API 參數：
名稱 | 帳戶類別 | 必填 |
asset | STRING | 否 |
startTime | 多頭 | 否 |
endTime | 多頭 | 否 |
size | 多頭 | 預設：10 上限：100 |
recvWindow | 多頭 | 否 |
timestamp | 多頭 | 是 |
API 回應：
回應類型 | 回應內容 |
一般回應 | [ { "asset": "USDT", "interest": "0.00000604", "principal": "0.04902887", "interestRate": "0.00012329", "type": "UM_NEGATIVE_BALANCE", "interestAccruedTime": 1678924800000 } ] |
7. 統一帳戶專業版利率 (USER_DATA)
API 參數：
名稱 | 帳戶類別 | 必填 |
asset | STRING | 否 |
recvWindow | 多頭 | 否 |
timestamp | 多頭 | 是 |
API 回應：
回應類型 | 回應內容 |
一般回應 | [ { "asset": "USDT", "dailyInterest": "0.00012329", //daily interest rate "yearlyInterest": "0.045" //annual interest rate } ] } |
8. 各幣種的階梯質押率
* 該接口僅對同一帳戶專業版生效，生效日期為2024年9月11日
GET /sapi/v2/portfolio/collateralRate
API 參數:
Name | Type | Mandatory |
recvWindow | LONG | NO |
timestamp | LONG | YES |
API 回應:
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" } ] } |
9. 錯誤代碼
若您在 API 端點遇到錯誤代碼「-21003」，或在 GUI 中遇到錯誤訊息「NET_ASSET_MUST_LTE_RATIO」，請嘗試將極小額之任何資產轉移至您的全倉錢包，錯誤會在轉帳後修復。