交易API申請

交易API 是面向自然人的直接交易接口。根據使用者的操作身份，申請流程分為兩種模式：

零售個人模式

適用於賬戶直接持有人。如需使用 交易API 交易本人名下賬戶，請自行發起申請。

機構交易員模式

適用於機構交易員。如需使用 交易API 操作被授權的機構自營賬戶，請聯繫機構管理員（Admin）完成授權申請。

零售個人模式申請流程

申請API

1. 打開Webull香港官網。點擊右上角登入按鈕，進行用戶登入（如果還沒有Webull用戶號，請先點擊登入按鈕旁邊註冊，先進行註冊）。

2. 可點擊【開發者管理中心】，跳轉至開發者管理中心。

如果沒有開戶，點擊【OpenAPI管理】->【我的申請】則會出現立即開戶按鈕。點擊立即開戶按照引導，提交開戶信息，需要等待開戶完成後才能申請API。

3. 開戶完成後，點擊【OpenAPI管理】->【我的申請】，進行API申請。

注意

API申請後，需要Webull運營人員進行審核，預計審核最快1～2個工作日。

申請完成後，會發送郵件至您開戶時填寫的郵箱。也可以在Webull香港官網openapi中点击【申請開通OpenAPI】,完成登陆后在【OpenAPI管理】-> 【我的申請】中查看，如下示圖：

獲取API密鑰

1. API申請審核通過後，就可以在【OpenAPI管理】-> 【API密鑰應用管理】開始註冊應用。 輸入您的應用名稱，並勾選"我已閱讀並接受相關協議"，進行應用註冊。

2. 註冊完成後，需要點擊【生成密鑰】進行密鑰生成。生成密鑰過程中，需要進行短信驗證碼和交易密碼校驗。 以下為密鑰生成後的示列，包含App Key、App Secret。

3. 可點擊【重置密鑰】進行App Secret重置。重置後，新密鑰立即生效，舊密鑰立即失效。

機構交易員模式申請流程

提示

對於管理員，請先完成Open API服務申請，再為組織內用戶授權Open API訪問，使他們能夠自建應用密鑰（AK）和隱私密鑰（SK），並透過API管理帳戶。

對非管理員用戶，請先聯繫管理員啟用Open API訪問，然後前往官網開發者工具中心建立api應用，按照頁面指示，在開發者中心創建個人開放API密鑰申請。

申請OpenAPI

生產環境

1. 打開 Webull Portal Prod，並使用您的Webull註冊帳號登入。（如果您還沒有 Webull 帳號，請先點擊註冊按鈕進行註冊）

   

2. 登入後，會顯示如下的「我的帳戶 >> 資產資訊」頁面：

   

   如果您尚未開設帳戶，請點擊【開設帳戶】按鈕並按照指示提交您的開戶資訊。您需要等到開戶完成後，才能申請 API

   

3. 帳戶開設完成後，請點擊【OpenAPI 管理】→【Open API 使用申請】來申請 API

   

注意

提交您的API申請後，Webull運營人員將會進行審核。最快預計需要1至2個工作天完成審核。

當您的申請獲批後，將會發送電子郵件至您註冊帳戶時所填寫的電子郵件地址。您也可以在【OpenAPI 管理】→【Open API 使用申請】中的Webull Portal Prod 查看狀態，如下所示：

沙箱環境

1. 打開 Webull Portal Sandbox，並使用您的Webull註冊帳號登入。（如果您還沒有 Webull 帳號，請先點擊註冊按鈕進行註冊）

   

2. 登入後，會顯示如下的「我的帳戶 >> 資產資訊」頁面：

   

   如果您尚未開設帳戶，請點擊【開設帳戶】按鈕並按照指示提交您的開戶資訊。您需要等到開戶完成後，才能申請 API

   

注意

沙箱環境提交開戶申請，持牌機構建議選「是」；生產環境按實際情況填寫。

選「是」可減少沙箱開戶資料填寫、加速流程，且沙箱資料不同步至生產，兩者完全隔離。

3. 帳戶開設完成後，請點擊【OpenAPI 管理】→【我的申請】來申請 API

   

   注意

   提交您的API申請後，Webull運營人員將會進行審核。最快預計需要1至2個工作天完成審核

   當您的申請獲批後，將會發送電子郵件至您註冊帳戶時所填寫的電子郵件地址。您也可以在Webull Portal Sandbox 中的【OpenAPI 管理】→【我的申請】查看狀態，如下所示：

   

Open API訪問授權交易員

1. 管理員可至【用戶管理】為組織內用戶授權開放API訪問。授權後，用戶可自製API密鑰並使用之進行操作

   

   

注意

請謹慎授權——授權用戶可通過其密鑰訪問門戶內所有帳戶。即將提供密鑰權限與用戶權限對應的功能。

獲取API密鑰

作為Open API被授權交易員，以下是密鑰產生後的範例，包含您的權限以及您所設定的 IP 白名單

1. 当您收到機構管理員邀请后，您可以在 【我的OpenAPI】 -> 【前往官網查看】 開始註冊您的應用程式

   

   如果您還沒有OpenAPI存取權限，【我的OpenAPI】 -> 【前往官網查看】 頁面將顯示如下：

   

提示

您可以聯繫機構管理員來賦予 OpenAPI存取權限

2. 輸入您的應用程式名稱，並勾選「我已閱讀並接受《API 協議》和《微牛證券（香港）免責聲明》」，即可註冊您的應用程式

   

   

3. 註冊完成後，點擊 【生成密鑰】以建立您的應用程式密鑰。在密鑰生成過程中，您需要完成短信驗證和交易密碼驗證。

   

   

4. 當您需要重設您的密鑰時，可以點擊 【重置密鑰】 來重設您的應用程式密鑰。重置後，新密鑰立即生效，舊密鑰將於 10天後失效。若需讓舊密鑰立即失效，您可以刪除密鑰應用。 :::tip提示

密鑰安全管理責任：密鑰的創建、命名、輪換、刪除等全生命週期操作，均由被授權使用者在開發者中心獨立管理。密鑰的存儲安全、訪問控制及使用合規性由被授權使用者全權負責。AK/SK 僅在生成時展示一次，請妥善保存。如遺失，需在開發者中心刪除舊密鑰應用並重新生成。

:::