最後更新：2023 年 5 月 5 日
幣安經典統一帳戶計畫可透過幣安合約 API 連結套組使用，並向所有已啟用幣安合約 API 交易介面的用戶開放。幣安經典統一帳戶計畫之中，全倉槓桿、U 本位合約和幣本位合約市場上現有的交易 API 端點仍可使用，且與一般帳戶交易做法一致。
請注意，經典統一帳戶 API 端點與幣安經典統一帳戶相容，且無法在新統一帳戶使用 (除非特殊狀況)。請參照這篇文章了解經典統一帳戶和新統一賬戶之間的區別。
若需新統一帳戶可用端點的完整清單，請參照幣安統一帳戶 API。
幣安經典統一帳戶計畫 API 詳情
幣安經典統一帳戶計畫除了幣安標準 API 端點以外，更新增專屬附加端點，提供下列輸出內容：
1. uniMMR、經典統一帳戶狀態
2. 破產貸款記錄 (GET) 與還款 (POST)
3. 各幣種的質押率
4. 各合約的名目限值
5. 其他經典統一帳戶計畫 API 例外
6. 經典統一帳戶資訊 (USER_DATA)
7. 經典統一帳戶利息記錄 (USER_DATA)
8. 經典統一帳戶利率 (USER_DATA)
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)
下列要求會回傳相對應的輸出內容：
欄位 | 說明 |
asset | 抵押品資產類型 |
collateralRate | 相應質押率 |
API 回應：
回應類型 | 回應內容 |
一般回應 | { "asset": "USDT", "collateralRate": "1.0000", } |
4. 各幣種的經典統一帳戶名目限額 (MARKET_DATA)
下列要求會回傳相對應的輸出內容：
欄位 | 說明 |
交易對 | 交易對 |
notionalLimit | USDT 計價的經典統一帳戶名目限額 |
API 參數：
| 名稱 | 帳戶類別 | 必填 |
| 幣種 | STRING | 否 |
API 回應：
回應類型 | 回應內容 |
一般回應 | { "notionalLimits": [ // Classic Portfolio Margin notional limit { "symbol": "BTCUSDT", // Symbol "notionalLimit": "100000000" // Classic Portfolio Margin Notional Limit in USDT }, { "symbol": "ETHUSDT", "notionalLimit": "20000000" }, ] } |
GET /dapi/v1/pmExchangeInfo
API 參數：
| 名稱 | 帳戶類別 | 必填 |
| 幣種 | STRING | 否 |
| pair | STRING | 否 |
API 回應：
回應類型 | 回應內容 |
一般回應 | { "notionalLimits": [ // Classic Portfolio Margin notional limit { "symbol": "BTCUSD_PERP", // Symbol "pair": "BTCUSD", // Pair " notionalLimit": "500" // Classic Portfolio Margin Notional Limit in coin }, { "symbol": "BTCUSD_220624", "pair": "BTCUSD", " notionalLimit": "200" } ] } |
5. 其他經典統一帳戶計畫 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” } |
6. 經典統一帳戶當前帳戶資訊
下列要求會回傳相對應的輸出內容：
欄位 | 說明 |
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 } |
7. 經典統一帳戶利息記錄 (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 } ] |
8. 經典統一帳戶利率 (USER_DATA)
API 參數：
| 名稱 | 帳戶類別 | 必填 |
| asset | STRING | 否 |
| recvWindow | 多頭 | 否 |
| timestamp | 多頭 | 是 |
API 回應：
回應類型 | 回應內容 |
一般回應 | [ { "asset": "USDT", "dailyInterest": "0.00012329", //daily interest rate "yearlyInterest": "0.045" //annual interest rate } ] } |
9. 錯誤代碼
若您在 API 端點遇到錯誤代碼「-21003」，或在 GUI 中遇到錯誤訊息「NET_ASSET_MUST_LTE_RATIO」，請嘗試將極小額之任何資產轉移至您的全倉錢包，錯誤會在轉帳後修復。