@@ -0,0 +1,45 @@
+# Webull OpenAPI Python SDK
+
+Note: This is the new version of the Webull SDK, currently applicable only to Webull Hong Kong, Webull US, or Webull JP customers.
+
+Webull OpenAPI aims to provide quantitative trading investors with convenient, fast and secure services. Webull aims to help every quant traders achieve flexible and changeable trading or market strategies.
+
+The main function:
+
+Trading management: create, modify, cancel orders, etc.
+
+Market information: You can query stocks/ETFs and other related market information through the HTTP interface.
+
+Account Information: Query account balance and position information.
+
+Subscription to real-time information: Subscribe to order status changes, market information, etc.
+
+## Requirements
+
+- Please first generate the app key and app secret on the Webull official website.
+
+| Broker    | Link                                            |
+|-----------|-------------------------------------------------|
+| Webull HK | https://www.webull.hk/open-api                  |
+| Webull US | https://www.webull.com/center#openApiManagement |
+| Webull JP | https://www.webull.co.jp/center/openapi/manage |
+
+- Requires Python 3.7 through 3.11.
+
+## Interface Protocol
+
+The bottom layer of Webull OpenAPI provides three protocols, HTTP / GRPC / MQTT, to support functions and features like trading, subscriptions for changes of order status and real-time market quotes.
+
+| Protocol | Description                                                                                                    |
+|----------|----------------------------------------------------------------------------------------------------------------|
+| HTTP     | It mainly provides interface services for data such as tradings, accounts, candlestick charts, snapshots, etc. |
+| GRPC	    | 1. Provide real-time push messages for order status changes.                                                   |
+| MQTT	    | Provides data services for real-time market conditions.                                                        |
+
+## Developer documentation
+
+| Broker    | Link                                     |
+|-----------|------------------------------------------|
+| Webull HK | https://developer.webull.hk/apis/docs    |
+| Webull US | https://developer.webull.com/apis/docs   |
+| Webull JP | https://developer.webull.co.jp/apis/docs |