Skip to main content

Account Balance

Interface Description

  • Function description: Query account assets according to account id.

  • Applicable objects: Customers who integrate into Webull through Webull OpenAPI.

  • Request URL: /account/balance

  • Request method: GET

  • Frequency limit: The calling frequency of each App ID is limited to 10 times in 30 seconds.

Request Parameters

ParameterTypeRequired fieldsDescriptionExample value
account_idStringYesAccount ID20150320010101001
total_asset_currencyStringNoCurrency, USD onlyUSD

Response Parameter

ParameterTypeDescriptionExample value
account_idStringAccount ID13467788
total_asset_currencyStringCurrency, USD onlyUSD
total_assetStringThe total assets of the account: the currency refers to the value of the total_asset_currency field.
total_market_value=sum(positions_market_value*exchange rate)
1247724759.52
total_market_valueStringThe total market value: the currency refers to the value of the total_asset_currency field.
total_asset=sum(net_liquidation_value*exchange rate)
89038914.52
total_cash_balanceStringThe total amount of cash: the currency refers to the value of the total_asset_currency field.total_cash_balance=sum(cash_balance*exchange rate)1158685845.00
margin_utilization_rateStringFinancing utilization: percentage.Parameters reserved.1.00
account_currency_assets[]Account_Currency_AssetAccount Asset List

The above exchange rate = the exchange rate at which the currency in Account_Currency_Asset is converted to total_asset_currency.

Account_Currency_Asset

ParameterTypeDescriptionExample value
currencyStringCurrency.USD
net_liquidation_valueStringNet assets.458809435.44
positions_market_valueStringThe market value of the position.153208546.14
cash_balanceStringCash balance.305600889.30
margin_powerStringFinancing buying power.305587431.94
cash_powerStringThe buying power of the cash account.305587431.94
pending_incomingStringIn-transit funds.0.00
cash_frozenStringFrozen funds.13457.36
available_withdrawalStringThe withdrawable amount.305587431.94
interests_unpaidStringInterest to be paid.0.00

Request Example

from webullsdktrade.api import API
from webullsdkcore.client import ApiClient
from webullsdkcore.common.region import Region
from webullsdktrade.common.currency import Currency

api_client = ApiClient(your_app_key, your_app_secret, Region.US.value)
api = API(api_client)
response = api.account.get_account_balance(account_id, Currency.USD.name)
if response.status_code == 200:
account_balance = response.json()

Response Example

{
"account_id":"6TGIBSMG28Q35OVA465T99VHPB",
"total_asset_currency":"USD",
"total_market_value":"0.00",
"margin_utilization_rate":"2.00",
"account_currency_assets":[
{
"currency":"USD",
"netAsset":"400000000.00",
"marketValue":"0.00",
"cashBalance":"400000000.00",
"marginPower":"1599995029.60",
"cashPower":"4799985859.00",
"cashInTransit":"0.00",
"cashFrozen":"485.10",
"cashWithdraw":"-2485.20",
"interestsUnpaid":"0.00"
}
]
}

Exception Example

{
"error_code": "INVALID_TOKEN",
"message": "401 UNAUTHORIZED \"app_id and account_id not related\""
}