常见问题
首页
帮助中心
常见问题
数字货币衍生品
合约交易
经典统一账户
如何使用幣安經典統一帳戶計畫 API

如何使用幣安經典統一帳戶計畫 API

2022-04-18 06:15
最後更新: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
pairSTRING
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 參數:
名稱帳戶類別必填
assetSTRING
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 參數:
名稱帳戶類別必填
assetSTRING
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 參數:
名稱帳戶類別必填
assetSTRING
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」,請嘗試將極小額之任何資產轉移至您的全倉錢包,錯誤會在轉帳後修復。