查詢賬戶單個幣種余額
支持查詢母帳戶的單個幣種餘額,以及母帳戶下各子帳戶的單個幣種餘額。 同時, 支持查詢母子帳戶、子子帳戶、子母帳戶之間的可劃轉金額,特別是針對於擁有機構借貸的用戶。
重要
無法通過子賬戶api key獲取主賬戶帳戶餘額
HTTP 請求
GET /asset/v3/private/transfer/account-coin/balance/query
請求參數
參數 | 是否必須 | 類型 | 說明 |
---|---|---|---|
memberId | false | string | 用戶ID. 當使用母帳號api key查詢子帳戶的幣種餘額時,該字段必傳 |
toMemberId | false | string | 劃入帳戶UID. 當查詢帳戶間劃轉時, 該字段必傳 |
accountType | true | string | 賬戶類型 |
toAccountType | false | string | 劃入帳戶類型. 當查詢不同帳戶類型間的劃轉時, 該字段必傳 |
coin | true | string | 幣種類型 |
withBonus | false | integer | 是否查詢體驗金. 0 (默認):不查詢; 1 :查詢 |
withTransferSafeAmount | false | integer | 是否查詢延遲提幣安全限額
|
withLtvTransferSafeAmount | false | integer | 特別用於機構借貸用戶, 可以查詢風險水平內的可劃轉餘額
|
返回參數
參數 | 類型 | 說明 |
---|---|---|
accountType | string | 賬戶類型 |
bizType | integer | 帳戶業務子類型 |
accountId | string | 賬戶ID |
memberId | string | 用戶ID |
balance | Object | |
> coin | string | 幣種類型 |
> walletBalance | string | 錢包余額 |
> transferBalance | string | 可划余額 |
> bonus | string | 体验金 |
> transferSafeAmount | string | 可劃轉的安全限額. 若不查詢,則返回"" |
> ltvTransferSafeAmount | string | 機構借貸用戶的可劃轉餘額. 若不查詢,則返回"" |
請求示例
GET /asset/v3/private/transfer/account-coin/balance/query?accountType=CONTRACT&coin=USDT&withTransferSafeAmount=1&withBonus=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1678794085278
X-BAPI-RECV-WINDOW: 50000
響應示例
{
"retCode": 0,
"retMsg": "success",
"result": {
"accountType": "CONTRACT",
"bizType": 1,
"accountId": "533285",
"memberId": "533285",
"balance": {
"coin": "USDT",
"walletBalance": "0",
"transferBalance": "-995.3506",
"bonus": "995.3506",
"transferSafeAmount": "-995.3506",
"ltvTransferSafeAmount": ""
}
},
"retExtInfo": {},
"time": 1678794085705
}