查詢賬戶單個幣種余額

支持查詢母帳戶的單個幣種餘額，以及母帳戶下各子帳戶的單個幣種餘額。 同時, 支持查詢母子帳戶、子子帳戶、子母帳戶之間的可劃轉金額，特別是針對於擁有機構借貸的用戶。

重要

無法通過子賬戶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	是否查詢延遲提幣安全限額 0(默認)：否, 1：是 什麼是延遲提幣?
withLtvTransferSafeAmount	false	integer	特別用於機構借貸用戶, 可以查詢風險水平內的可劃轉餘額 0(default)：false, 1：true 此時toAccountType字段必傳

返回參數

參數	類型	說明
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
}