查詢錢包餘額

獲取統一帳戶和經典帳戶錢包餘額, 查詢各個幣種的資產信息，以及統一保證金模式下的帳戶風險率信息。默認不返回資產或負債為0的幣種信息。

提示

UTA交易反向合約是通過該帳戶下的CONTRACT錢包進行
請使用該接口查詢資金帳戶的餘額

HTTP 請求

GET /v5/account/wallet-balance

請求參數

參數	是否必需	類型	說明
accountType	true	string	帳戶類型. 統一帳戶: `UNIFIED`(現貨/USDT和USDC永續/期權), `CONTRACT`(反向) 經典帳戶: `CONTRACT`(期貨), `SPOT`(現貨)
coin	false	string	幣種名稱不傳則返回非零資產信息可以傳多個幣進行查詢，以逗號分隔, `USDT,USDC`

響應參數

參數	類型	說明
list	array	Object
> accountType	string	帳戶類型
> accountLTV	string	字段廢棄
> accountIMRate	string	帳戶初始保證金率: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin. 非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
> accountMMRate	string	帳戶維持保證金率: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
> totalEquity	string	總凈值為賬戶中每個幣種資產凈值的法幣估值之和。。非統一保證金模式以及統一帳戶(反向)下，該字段返回為空。
> totalWalletBalance	string	賬戶維度換算成usd的產錢包餘額：∑ Asset Wallet Balance By USD value of each asset。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
> totalMarginBalance	string	賬戶維度換算成usd的保證金餘額：totalWalletBalance + totalPerpUPL。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
> totalAvailableBalance	string	賬戶維度換算成usd的可用餘額：RM：totalMarginBalance - totalInitialMargin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
> totalPerpUPL	string	賬戶維度換算成usd的永續和USDC交割合約的浮動盈虧：∑ Each perp and USDC Futures upl by base coin。非統一保證金模式以及統一帳戶(反向)下，該字段返回為空。
> totalInitialMargin	string	賬戶維度換算成usd的總初始保證金：∑ Asset Total Initial Margin Base Coin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
> totalMaintenanceMargin	string	賬戶維度換算成usd的總維持保證金: ∑ Asset Total Maintenance Margin Base Coin。非統一保證金模式和統一帳戶(反向)以及統一帳戶(逐倉模式)，該字段返回為空。
> coin	arrays	幣種列表
>> coin	string	幣種名稱，例如 BTC，ETH，USDT，USDC
>> equity	string	當前幣種的資產淨值
>> usdValue	string	當前幣種折算成 usd 的價值
>> walletBalance	string	當前幣種的錢包餘額
>> free	string	經典帳戶現貨錢包的可用餘額. 經典帳戶現貨錢包的獨有字段
>> locked	string	現貨掛單凍結金額
>> spotHedgingQty	string	用於組合保證金(PM)現貨對衝的數量, 截斷至8為小數, 默認為0 統一帳戶的獨有字段
>> borrowAmount	string	當前幣種的已用借貸額度
>> availableToBorrow	string	由於母子共享借貸限額, 該字段已廢棄, 總是返回`""`. 請通過查詢抵押品信息接口查詢`availableToBorrow`
>> availableToWithdraw	string	當前幣種的可劃轉提現金額
>> accruedInterest	string	當前幣種的預計要在下一個利息週期收取的利息金額
>> totalOrderIM	string	以當前幣種結算的訂單委託預佔用保證金. 組合保證金模式下，該字段返回空字符串
>> totalPositionIM	string	以當前幣種結算的所有倉位起始保證金求和 + 所有倉位的預佔用平倉手續費. 組合保證金模式下，該字段返回空字符串
>> totalPositionMM	string	以當前幣種結算的所有倉位維持保證金求和. 組合保證金模式下，該字段返回空字符串
>> unrealisedPnl	string	以當前幣種結算的所有倉位的未結盈虧之和
>> cumRealisedPnl	string	以當前幣種結算的所有倉位的累計已結盈虧之和
>> bonus	string	體驗金. UNIFIED帳戶的獨有字段
>> marginCollateral	boolean	是否可作為保證金抵押幣種(平台維度), `true`: 是. `false`: 否當marginCollateral=false時, 則collateralSwitch無意義 UNIFIED帳戶的獨有字段
>> collateralSwitch	boolean	用戶是否開啟保證金幣種抵押(用戶維度), `true`: 是. `false`: 否僅當marginCollateral=true時, 才能主動選擇開關抵押 UNIFIED帳戶的獨有字段

請求示例

HTTP
Python

GET /v5/account/wallet-balance?accountType=UNIFIED&coin=BTC HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672125440406
X-BAPI-RECV-WINDOW: 5000

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

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "totalEquity": "18070.32797922",
                "accountIMRate": "0.0101",
                "totalMarginBalance": "18070.32797922",
                "totalInitialMargin": "182.60183684",
                "accountType": "UNIFIED",
                "totalAvailableBalance": "17887.72614237",
                "accountMMRate": "0",
                "totalPerpUPL": "-0.11001349",
                "totalWalletBalance": "18070.43799271",
                "accountLTV": "0.017",
                "totalMaintenanceMargin": "0.38106773",
                "coin": [
                    {
                        "availableToBorrow": "3",
                        "bonus": "0",
                        "accruedInterest": "0",
                        "availableToWithdraw": "0",
                        "totalOrderIM": "0",
                        "equity": "0",
                        "totalPositionMM": "0",
                        "usdValue": "0",
                        "spotHedgingQty": "0.01592413",
                        "unrealisedPnl": "0",
                        "collateralSwitch": true,
                        "borrowAmount": "0.0",
                        "totalPositionIM": "0",
                        "walletBalance": "0",
                        "cumRealisedPnl": "0",
                        "locked": "0",
                        "marginCollateral": true,
                        "coin": "BTC"
                    }
                ]
            }
        ]
    },
    "retExtInfo": {},
    "time": 1672125441042
}

HTTP 請求​

請求參數​

響應參數​

請求示例​

響應示例​

HTTP 請求

請求參數

響應參數

請求示例

響應示例