最後更新: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」,請嘗試將極小額之任何資產轉移至您的全倉錢包,錯誤會在轉帳後修復。