账户余额
接口说明
功能说明：根据账户id查询账户资产。
适用对象：通过OpenApi开发平台对接webull的客户。
请求URL：/account/balance
请求方式：GET
频次限制：每个AppId调用频次限制为2秒2次。
请求参数
| 参数 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| account_id | String | 是 | 账户id | 20150320010101001 |
| total_asset_currency | String | 否 | 总资产计价币种，取值参考字典值Currency，若为空则默认为HKD | HKD |
响应参数
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| account_id | String | 账户id | 13467788 |
| total_asset_currency | String | 总资产计价币种，取值参考字典值Currency | HKD |
| total_asset | String | 账户总资产，币种为total_asset_currency字段值。 total_asset=sum(net_liquidation_value*汇率) | 1247724759.5266750000 |
| total_market_value | String | 总市值，币种为total_asset_currency字段值。 total_market_value=sum(positions_market_value*汇率) | 89038914.5212380000 |
| total_cash_balance | String | 现金总额，币种为total_asset_currency字段值。 total_cash_balance=sum(cash_balance*汇率) | 1158685845.0054370000 |
| margin_utilization_rate | String | 融资使用率，百分比。预留参数 | 1.00 |
| account_currency_assets | []Account_Currency_Asset | 账户资产列表 |
上述的汇率=Account_Currency_Asset中的currency币种兑换成total_asset_currency币种的汇率。
Account_Currency_Asset
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| currency | String | 币种，取值参考字典值Currency | HKD |
| net_liquidation_value | String | 净资产 net_liquidation_value=positions_market_value+cash_balance+pending_incoming | 458809435.440000 |
| positions_market_value | String | 持仓市值 | 153208546.140000 |
| cash_balance | String | 现金余额 | 305600889.300000 |
| margin_power | String | 融资购买力 | 305587431.940000 |
| cash_power | String | 现金购买力 | 305587431.940000 |
| pending_incoming | String | 在途资金 | 0.000000 |
| cash_frozen | String | 冻结资金 | 13457.360000 |
| available_withdrawal | String | 可提现金额 | 305587431.940000 |
| interests_unpaid | String | 待付利息 | 0.000000 |
请求示例
- Python
- Java
from webullsdktrade.api import API
from webullsdkcore.client import ApiClient
from webullsdkcore.common.region import Region
api_client = ApiClient(your_app_key, your_app_secret, Region.HK.value)
api = API(api_client)
response = api.account.get_account_balance(account_id,currency)
if response.status_code == 200:
account_balance = response.json()
HttpApiConfig apiConfig = HttpApiConfig.builder()
.appKey(Env.APP_KEY)
.appSecret(Env.APP_SECRET)
.regionId(Region.hk.name())
.build();
TradeApiService apiService = new TradeHttpApiService(apiConfig);
AccountBalance accountBalance = apiService.getAccountBalance(accountId, currency);