跳至主要内容

查詢帳戶單個幣種餘額

獲取某帳戶類型下某指定幣種的餘額。支持通過輸入子帳戶id來查詢子帳戶的某個帳戶類型下的某個幣種餘額 同時, 支持查詢母子帳戶、子子帳戶、子母帳戶之間的可劃轉金額,特別是針對於擁有機構借貸的用戶。

HTTP 請求

GET /v5/asset/transfer/query-account-coin-balance

請求參數

參數是否必需類型說明
memberIdfalsestring用戶Id. 當查詢子帳號的餘額時,該字段必傳
toMemberIdfalsestring劃入帳戶UID. 當查詢不同uid間劃轉時, 該字段必傳
accountTypetruestring帳戶類型
toAccountTypefalsestring劃入帳戶類型. 當查詢不同帳戶類型間的劃轉時, 該字段必傳
cointruestring幣種
withBonusfalseinteger是否查詢體驗金. 0(默認): 不查詢,1: 查詢.
withTransferSafeAmountfalseinteger是否查詢延遲提幣安全限額
withLtvTransferSafeAmountfalseinteger特別用於機構借貸用戶, 可以查詢風險水平內的可劃轉餘額
  • 0(default):false, 1:true
  • 此時toAccountType字段必傳

響應參數

參數類型說明
accountTypestring賬戶類型
bizTypeinteger帳戶業務子類型
accountIdstring賬戶ID
memberIdstring用戶ID
balanceObject
> coinstring幣種類型
> walletBalancestring錢包余額
> transferBalancestring可划余額
> bonusstring可用金額中包含的体验金
> transferSafeAmountstring可劃轉的安全限額. 若不查詢,則返回""
> ltvTransferSafeAmountstring機構借貸用戶的可劃轉餘額. 若不查詢,則返回""

請求示例

GET /v5/asset/transfer/query-account-coin-balance?accountType=UNIFIED&coin=USDT&toAccountType=FUND&withLtvTransferSafeAmount=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxx
X-BAPI-API-KEY: xxxxx
X-BAPI-TIMESTAMP: 1690254520644
X-BAPI-RECV-WINDOW: 5000

響應示例

{
"retCode": 0,
"retMsg": "success",
"result": {
"accountType": "UNIFIED",
"bizType": 1,
"accountId": "1631385",
"memberId": "1631373",
"balance": {
"coin": "USDT",
"walletBalance": "11999",
"transferBalance": "11999",
"bonus": "0",
"transferSafeAmount": "",
"ltvTransferSafeAmount": "7602.4861"
}
},
"retExtInfo": {},
"time": 1690254521256
}