賬戶餘額
接口說明
功能說明：根據賬戶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);