Assets

Webull’s Assets API enables developers to retrieve asset information over HTTP. For details, please refer to the API Reference.

Before calling the Assets API, you need to have an App Key and Secret. For details, please refer to the Individual Application Process.

1. Base URLs

• Production Environment: https://api.webull.com/
• Test Environment: http://us-openapi-alb.uat.webullbroker.com/

2. Code Example

Python

from webull.core.client import ApiClient
from webull.trade.trade_client import TradeClient

optional_api_endpoint = "<webull_api_host>" # PRD env host: api.webull.com; Test env host: us-openapi-alb.uat.webullbroker.com
your_app_key = "<your_app_key>"
your_app_secret = "<your_app_secret>"
region_id = "us"
account_id = "<your_account_id>" # Use account_list interface to get account info
api_client = ApiClient(your_app_key, your_app_secret, region_id)
api_client.add_endpoint(region_id, optional_api_endpoint)


if __name__ == '__main__':
    trade_client = TradeClient(api_client)

    res = trade_client.account_v2.get_account_balance("account_id")
    if res.status_code == 200:
        print('get account balance info:', res.json())

    res = trade_client.account_v2.get_account_position("account_id")
    if res.status_code == 200:
        print('get account positions info:', res.json())

Java

import com.webull.openapi.core.http.HttpApiConfig;
import com.webull.openapi.core.logger.Logger;
import com.webull.openapi.core.logger.LoggerFactory;
import com.webull.openapi.samples.account.AccountList;
import com.webull.openapi.samples.config.Env;
import com.webull.openapi.trade.response.v2.AccountBalanceInfo;
import com.webull.openapi.trade.response.v2.AccountPositionsInfo;

import java.util.List;

public class AssetsClient {
    private static final Logger logger = LoggerFactory.getLogger(AssetsClient.class);

    public static void main(String[] args) throws InterruptedException {
        HttpApiConfig apiConfig = HttpApiConfig.builder()
                .appKey("<your_app_key>")                //<your_app_key>
                .appSecret("<your_app_secret>")          //<your_app_secret>
                .regionId("us")                          //<your_region_id> @see com.webull.openapi.core.common.Region
                .endpoint("<webull_api_host>")           //PRD env host: api.webull.com; Test env host: us-openapi-alb.uat.webullbroker.com
                .build();
        com.webull.openapi.trade.TradeClientV2 apiService = new com.webull.openapi.trade.TradeClientV2(apiConfig);

        // Use getAccountList interface to get account info
        String accountId = "#{accountId}"; 
        // get account balance information
        AccountBalanceInfo balanceInfo = apiService.balanceAccount(accountId);
        logger.info("BalanceInfo: {}", balanceInfo);

        List<AccountPositionsInfo> positionsInfos = apiService.positionsAccount(accountId);
        logger.info("PositionsInfos: {}", positionsInfos);

    }

}