帳戶

Webull 的帳戶 API 允許開發者通過 HTTP 協議查詢帳戶資訊。 詳細內容請參閱 帳戶管理介面

在調用帳戶 API 前，您需要擁有 App Key 與 App Secret。

• 個人用戶請參考 這裡。
• 機構用戶請參考 這裡。

注意

根據香港的安全與合規要求，除了需透過 App Key 及 App Secret 進行身份驗證外，OpenAPI 還要求使用 Token 進行身份驗證。 有關 Token 的產生與驗證，請參考：Token 產生與驗證

1. 基礎 URL

• 正式環境: https://api.webull.hk/
• 沙盒環境: https://api.sandbox.webull.hk

2. 範例

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.hk. Test env host: api.sanbox.webull.hk
your_app_key = "<your_app_key>"
your_app_secret = "<your_app_secret>"
region_id = "hk"
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_list()
    if res.status_code == 200:
        print('get account list:', res.json())

Java

public class AccountList {
    private static final Logger logger = LoggerFactory.getLogger(AccountList.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("hk")                          //<your_region_id> @see com.webull.openapi.core.common.Region
                .endpoint("<webull_api_host>")           //PRD env host: api.webull.hk. Test env host: api.sanbox.webull.hk
                .build();
        
        com.webull.openapi.trade.TradeClientV2 apiService = new com.webull.openapi.trade.TradeClientV2(apiConfig);

        // get account list
        List<Account> accounts = apiService.listAccount();
        logger.info("Accounts: {}", accounts);
    }
}