查詢帳戶單個幣種餘額

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

警告

• 無法通過子賬戶api key獲取主賬戶帳戶餘額
• 子帳戶只能查詢本身的餘額
• 母帳戶支持本身和它的子帳戶的餘額

HTTP 請求

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

請求參數

參數	是否必需	類型	說明
memberId	false	string	用戶Id. 當查詢子帳號的餘額時，該字段必傳
toMemberId	false	string	劃入帳戶UID. 當查詢不同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	機構借貸用戶的可劃轉餘額. 若不查詢，則返回""

---

請求示例

HTTP

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

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_coin_balance(
    accountType="UNIFIED",
    coin="BTC",
    memberId=592324,
))

響應示例

{
    "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
}