賬戶餘額

接口說明

• 功能說明：根據賬戶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

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()

Java

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);

響應示例

{
  "account_id": "QJHO3P1PR9425Q6UAT7QLJTEKB",
  "total_asset_currency": "CNH",
  "total_asset": "1247724759.5266750000",
  "total_market_value": "89038914.5212380000",
  "total_cash_balance": "1158685845.0054370000",
  "margin_utilization_rate": "1.00",
  "account_currency_assets": [
      {
          "currency": "CNH",
          "net_liquidation_value": "1008356844.580000",
          "positions_market_value": "9110016.000000",
          "cash_balance": "999246828.580000",
          "margin_power": "999246828.580000",
          "cash_power": "999246828.580000",
          "pending_incoming": "0.000000",
          "cash_frozen": "0.000000",
          "available_withdrawal": "999246828.580000"
      },
      {
          "currency": "HKD",
          "net_liquidation_value": "458809435.440000",
          "positions_market_value": "153208546.140000",
          "cash_balance": "305600889.300000",
          "margin_power": "305587431.940000",
          "cash_power": "305587431.940000",
          "pending_incoming": "0.000000",
          "cash_frozen": "13457.360000",
          "available_withdrawal": "305587431.940000"
      },
      {
          "currency": "USD",
          "net_liquidation_value": "934.710000",
          "positions_market_value": "0.000000",
          "cash_balance": "934.710000",
          "margin_power": "5.050000",
          "cash_power": "5.050000",
          "pending_incoming": "0.000000",
          "cash_frozen": "929.660000",
          "available_withdrawal": "5.050000"
      }
  ]
}

異常示例

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