webull-openapi-mcp 1.2.3__tar.gz → 1.2.4__tar.gz

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/.env.example

@@ -20,7 +20,7 @@ WEBULL_APP_SECRET=
 # Set to 'prod' for live trading (use with caution)
 # WEBULL_ENVIRONMENT=uat
 
-# Region ID: us, hk, jp, sg, th, my, uk, mx, br, eu, za, or au
+# Region ID: us, hk, jp, sg, my, uk, mx, br, or za
 # Default: us
 # WEBULL_REGION_ID=us
 

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: webull-openapi-mcp
-Version: 1.2.3
+Version: 1.2.4
 Summary: MCP Server for Webull OpenAPI - enables AI assistants to securely access Webull trading and market data
 Project-URL: Homepage, https://github.com/webull-inc/webull-openapi-mcp
 Project-URL: Repository, https://github.com/webull-inc/webull-openapi-mcp
@@ -20,7 +20,7 @@ Requires-Python: <3.13,>=3.10
 Requires-Dist: click
 Requires-Dist: fastmcp==3.0.2
 Requires-Dist: python-dotenv
-Requires-Dist: webull-openapi-python-sdk==2.0.17
+Requires-Dist: webull-openapi-python-sdk==3.0.0
 Provides-Extra: dev
 Requires-Dist: hypothesis; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
@@ -49,7 +49,7 @@ See [DISCLAIMER.md](DISCLAIMER.md) for the full disclaimer.
 
 ## Features
 
-- **Multi-Region Support** — US, HK, JP, SG, TH, MY, UK, MX, BR, EU, ZA, and AU regions with region-specific order types, trading sessions, and validation
+- **Multi-Region Support** — US, HK, JP, SG, MY, UK, MX, BR, and ZA regions with region-specific order types, trading sessions, and validation
 - **Market Data** — Real-time snapshots, tick data, quotes (depth), footprint, and OHLCV bars for stocks, options, futures, crypto, and event contracts
 - **NOII Data** — Net Order Imbalance Indicator bars and snapshots for US stock opening/closing auctions
 - **Screener** — Top gainers/losers, most active, market sectors, high dividend, and 52-week high/low rankings
@@ -146,12 +146,9 @@ Here are some prompts you can use with your AI assistant:
    - HK: [developer.webull.hk](https://developer.webull.hk/apis/home)
    - JP: [developer.webull.co.jp](https://developer.webull.co.jp/)
    - SG: [developer.webull.com.sg](https://developer.webull.com.sg/apis/home)
-   - TH: [developer.webull.co.th](https://developer.webull.co.th/apis/home)
    - MY: [developer.webull.com.my](https://developer.webull.com.my/apis/home)
    - UK: [developer.webull-uk.com](https://developer.webull-uk.com/apis/home)
-   - EU: [developer.webull.eu](https://developer.webull.eu/apis/home)
    - ZA: [developer.webull.co.za](https://developer.webull.co.za/apis/home)
-   - AU: [developer.webull.com.au](https://developer.webull.com.au/apis/home)
    - MX: [developer.webull.com.mx](https://developer.webull.com.mx/apis/home)
    - BR: [developer.webull.com.br](https://developer.webull.com.br/apis/home)
 2. **API Credentials** — Obtain your `App Key` and `App Secret`
@@ -160,12 +157,9 @@ Here are some prompts you can use with your AI assistant:
    - HK: [webullapp.hk/quote](https://www.webullapp.hk/quote) | [Guide](https://developer.webull.hk/apis/docs/market-data-api/subscribe-quotes)
    - JP: [webull.co.jp/pricing](https://www.webull.co.jp/pricing) | [Guide](https://developer.webull.co.jp/api-doc/market-data/subscribe-quotes/)
    - SG: [webull.com.sg/quote](https://www.webull.com.sg/quote) | [Guide](https://developer.webull.com.sg/apis/docs/market-data-api/subscribe-quotes)
-   - TH: [webull.co.th/quote](https://www.webull.co.th/quote) | [Guide](https://developer.webull.co.th/apis/docs/market-data-api/subscribe-quotes)
    - MY: [webull.com.my/quote](https://www.webull.com.my/quote) | [Guide](https://developer.webull.com.my/apis/docs/market-data-api/subscribe-quotes)
    - UK: [webull-uk.com/quote](https://www.webull-uk.com/quote) | [Guide](https://developer.webull-uk.com/apis/docs/market-data-api/subscribe-quotes)
-   - EU: [webullapp.eu/quote](https://www.webullapp.eu/quote) | [Guide](https://developer.webull.eu/apis/docs/market-data-api/subscribe-quotes)
    - ZA: [webullapp.co.za/quote](https://www.webullapp.co.za/quote) | [Guide](https://developer.webull.co.za/apis/docs/market-data-api/subscribe-quotes)
-   - AU: [webullapp.com.au/quote](https://www.webullapp.com.au/quote) | [Guide](https://developer.webull.com.au/apis/docs/market-data-api/subscribe-quotes)
    - MX: [webull.com.mx/quote](https://www.webull.com.mx/quote) | [Guide](https://developer.webull.com.mx/apis/docs/market-data-api/subscribe-quotes)
    - BR: [webull.com.br/quote](https://www.webull.com.br/quote) | [Guide](https://developer.webull.com.br/apis/docs/market-data-api/subscribe-quotes)
 4. **Python 3.10+**
@@ -310,7 +304,7 @@ Add to your MCP configuration:
 | `WEBULL_APP_KEY` | App Key (required) | — |
 | `WEBULL_APP_SECRET` | App Secret (required) | — |
 | `WEBULL_ENVIRONMENT` | `uat` (sandbox) or `prod` | `uat` |
-| `WEBULL_REGION_ID` | `us`, `hk`, `jp`, `sg`, `th`, `my`, `uk`, `mx`, `br`, `eu`, `za`, or `au` | `us` |
+| `WEBULL_REGION_ID` | `us`, `hk`, `jp`, `sg`, `my`, `uk`, `mx`, `br`, or `za` | `us` |
 | `WEBULL_TOOLSETS` | Enabled tool categories (comma-separated). Valid values: `account`, `market-data`, `trading`, `instrument` | (all enabled) |
 | `WEBULL_MAX_ORDER_NOTIONAL_USD` | Max order value for US market (USD) | `10000` |
 | `WEBULL_MAX_ORDER_NOTIONAL_HKD` | Max order value for HK market (HKD) | `80000` |
@@ -322,7 +316,7 @@ Add to your MCP configuration:
 | `WEBULL_AUDIT_LOG_FILE` | Audit log file path | stderr only |
 | `WEBULL_LOG_LEVEL` | SDK log level | `WARNING` |
 
-> **Note:** `WEBULL_REGION_ID=us` represents **Webull US** ([developer.webull.com](https://developer.webull.com/apis/home)), `WEBULL_REGION_ID=hk` represents **Webull Hong Kong** ([developer.webull.hk](https://developer.webull.hk/apis/home)), `WEBULL_REGION_ID=jp` represents **Webull Japan** ([developer.webull.co.jp](https://developer.webull.co.jp/)), `WEBULL_REGION_ID=sg` represents **Webull Singapore** ([developer.webull.com.sg](https://developer.webull.com.sg/apis/home)), `WEBULL_REGION_ID=th` represents **Webull Thailand** ([developer.webull.co.th](https://developer.webull.co.th/apis/home)), `WEBULL_REGION_ID=my` represents **Webull Malaysia** ([developer.webull.com.my](https://developer.webull.com.my/apis/home)), `WEBULL_REGION_ID=uk` represents **Webull UK** ([developer.webull-uk.com](https://developer.webull-uk.com/apis/home)), `WEBULL_REGION_ID=mx` represents **Webull Mexico** ([developer.webull.com.mx](https://developer.webull.com.mx/apis/home)), `WEBULL_REGION_ID=br` represents **Webull Brazil** ([developer.webull.com.br](https://developer.webull.com.br/apis/home)), `WEBULL_REGION_ID=eu` represents **Webull EU** ([developer.webull.eu](https://developer.webull.eu/apis/home)), `WEBULL_REGION_ID=za` represents **Webull South Africa** ([developer.webull.co.za](https://developer.webull.co.za/apis/home)), and `WEBULL_REGION_ID=au` represents **Webull Australia** ([developer.webull.com.au](https://developer.webull.com.au/apis/home)).
+> **Note:** `WEBULL_REGION_ID=us` represents **Webull US** ([developer.webull.com](https://developer.webull.com/apis/home)), `WEBULL_REGION_ID=hk` represents **Webull Hong Kong** ([developer.webull.hk](https://developer.webull.hk/apis/home)), `WEBULL_REGION_ID=jp` represents **Webull Japan** ([developer.webull.co.jp](https://developer.webull.co.jp/)), `WEBULL_REGION_ID=sg` represents **Webull Singapore** ([developer.webull.com.sg](https://developer.webull.com.sg/apis/home)), `WEBULL_REGION_ID=my` represents **Webull Malaysia** ([developer.webull.com.my](https://developer.webull.com.my/apis/home)), `WEBULL_REGION_ID=uk` represents **Webull UK** ([developer.webull-uk.com](https://developer.webull-uk.com/apis/home)), `WEBULL_REGION_ID=mx` represents **Webull Mexico** ([developer.webull.com.mx](https://developer.webull.com.mx/apis/home)), `WEBULL_REGION_ID=br` represents **Webull Brazil** ([developer.webull.com.br](https://developer.webull.com.br/apis/home)), and `WEBULL_REGION_ID=za` represents **Webull South Africa** ([developer.webull.co.za](https://developer.webull.co.za/apis/home)).
 
 See [.env.example](.env.example) for full configuration template.
 
@@ -370,28 +364,28 @@ See [.env.example](.env.example) for full configuration template.
 
 ### Region Differences
 
-| Feature                     | US | HK | JP | SG | TH | MY | UK | MX | BR | EU | ZA | AU |
-|-----------------------------|----|----|----|----|----|----|-----|----|----|----|----|-----|
-| Stock Trading               | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Option Trading              | Yes | Yes | No | No | No | No | No | No | No | No | No | No |
-| Futures Trading             | Yes | Yes | No | No | No | No | No | No | No | No | No | No |
-| Crypto Trading              | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Event Contracts             | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Combo Orders                | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Option Strategies           | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Algo Orders                 | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Screener                    | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Watchlist                   | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Fundamental (Company/Analyst) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Stock/Fund Fundamentals     | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Financial Statements        | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| NOII (Auction Imbalance)    | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Markets                     | US | US, HK, CN | US, JP | US | US | US | US | US | US | US | US | US |
-| Instrument Categories       | US_STOCK, US_ETF | US_STOCK, US_ETF, HK_STOCK, CN_STOCK | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF |
-| Order Types                 | LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT, TRAILING_STOP_LOSS, etc. | LIMIT, MARKET, ENHANCED_LIMIT, AT_AUCTION, AT_AUCTION_LIMIT, etc. | JP market: LIMIT, MARKET — US market: LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT |
-| Time-in-Force               | DAY, GTC | US market: DAY, GTC, GTD — HK market: DAY, GTC — CN market: DAY | JP market: DAY — US market: DAY, GTC, GTD | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC |
-| Trading Sessions            | ALL, CORE, NIGHT | CORE, ALL_DAY, NIGHT, ALL | CORE, ALL, NIGHT, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY |
-| JP Order Fields             | — | — | `account_tax_type` required (GENERAL or SPECIFIC); `margin_type` (ONE_DAY or INDEFINITE) and `position_intent` optional margin-account-only fields; `close_contracts` optional | — | — | — | — | — | — | — | — | — |
+| Feature                     | US | HK | JP | SG | MY | UK | MX | BR | ZA |
+|-----------------------------|----|----|----|----|----|-----|----|----|----|
+| Stock Trading               | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Option Trading              | Yes | Yes | No | No | No | No | No | No | No |
+| Futures Trading             | Yes | Yes | No | No | No | No | No | No | No |
+| Crypto Trading              | Yes | No | No | No | No | No | No | No | No |
+| Event Contracts             | Yes | No | No | No | No | No | No | No | No |
+| Combo Orders                | Yes | No | No | No | No | No | No | No | No |
+| Option Strategies           | Yes | No | No | No | No | No | No | No | No |
+| Algo Orders                 | Yes | No | No | No | No | No | No | No | No |
+| Screener                    | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Watchlist                   | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Fundamental (Company/Analyst) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Stock/Fund Fundamentals     | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Financial Statements        | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| NOII (Auction Imbalance)    | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Markets                     | US | US, HK, CN | US, JP | US | US | US | US | US | US |
+| Instrument Categories       | US_STOCK, US_ETF | US_STOCK, US_ETF, HK_STOCK, CN_STOCK | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF |
+| Order Types                 | LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT, TRAILING_STOP_LOSS, etc. | LIMIT, MARKET, ENHANCED_LIMIT, AT_AUCTION, AT_AUCTION_LIMIT, etc. | JP market: LIMIT, MARKET — US market: LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT |
+| Time-in-Force               | DAY, GTC | US market: DAY, GTC, GTD — HK market: DAY, GTC — CN market: DAY | JP market: DAY — US market: DAY, GTC, GTD | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC |
+| Trading Sessions            | ALL, CORE, NIGHT | CORE, ALL_DAY, NIGHT, ALL | CORE, ALL, NIGHT, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY |
+| JP Order Fields             | — | — | `account_tax_type` required (GENERAL or SPECIFIC); `margin_type` (ONE_DAY or INDEFINITE) and `position_intent` optional margin-account-only fields; `close_contracts` optional | — | — | — | — | — | — |
 
 > **Note:** Screener (Gainers/Losers/Active), Fundamental (Company/Analyst), and NOII currently only support querying US stock data (`US_STOCK` category). Stock/Fund Fundamentals, Financial Statements, and the extended Screener (Sectors/Dividend/52W) are available in all regions; supported `category` values vary by endpoint (commonly `US_STOCK`, `HK_STOCK`, `CN_STOCK`, `JP_STOCK`). Watchlist supports US stocks and HK stocks.
 
@@ -438,7 +432,7 @@ All commands accept `--env-file PATH` to specify a custom `.env` file location (
 - **Review before trading** — Always review order details proposed by the AI before confirming. Use `preview_stock_order` / `preview_option_order` before placing orders.
 - **Use toolset filtering** — Set `WEBULL_TOOLSETS=account,market-data` to disable trading tools entirely if you only need read-only access. Valid toolsets: `account`, `market-data`, `trading`, `instrument`.
 - **Default sandbox** — The server defaults to UAT (sandbox) environment. You must explicitly set `WEBULL_ENVIRONMENT=prod` for live trading.
-- **Dependency security** — `fastmcp` is pinned to version `3.0.2` and `webull-openapi-python-sdk` is pinned to `2.0.16`. Users are responsible for monitoring and updating third-party dependencies for security patches. Review release notes before upgrading.
+- **Dependency security** — `fastmcp` is pinned to version `3.0.2` and `webull-openapi-python-sdk` is pinned to `3.0.0`. Users are responsible for monitoring and updating third-party dependencies for security patches. Review release notes before upgrading.
 
 ---
 
@@ -479,12 +473,9 @@ Subscribe to quotes:
 - HK: [webullapp.hk/quote](https://www.webullapp.hk/quote) | [Guide](https://developer.webull.hk/apis/docs/market-data-api/subscribe-quotes)
 - JP: [webull.co.jp/pricing](https://www.webull.co.jp/pricing) | [Guide](https://developer.webull.co.jp/api-doc/market-data/subscribe-quotes/)
 - SG: [webull.com.sg/quote](https://www.webull.com.sg/quote) | [Guide](https://developer.webull.com.sg/apis/docs/market-data-api/subscribe-quotes)
-- TH: [webull.co.th/quote](https://www.webull.co.th/quote) | [Guide](https://developer.webull.co.th/apis/docs/market-data-api/subscribe-quotes)
 - MY: [webull.com.my/quote](https://www.webull.com.my/quote) | [Guide](https://developer.webull.com.my/apis/docs/market-data-api/subscribe-quotes)
 - UK: [webull-uk.com/quote](https://www.webull-uk.com/quote) | [Guide](https://developer.webull-uk.com/apis/docs/market-data-api/subscribe-quotes)
-- EU: [webullapp.eu/quote](https://www.webullapp.eu/quote) | [Guide](https://developer.webull.eu/apis/docs/market-data-api/subscribe-quotes)
 - ZA: [webullapp.co.za/quote](https://www.webullapp.co.za/quote) | [Guide](https://developer.webull.co.za/apis/docs/market-data-api/subscribe-quotes)
-- AU: [webullapp.com.au/quote](https://www.webullapp.com.au/quote) | [Guide](https://developer.webull.com.au/apis/docs/market-data-api/subscribe-quotes)
 - MX: [webull.com.mx/quote](https://www.webull.com.mx/quote) | [Guide](https://developer.webull.com.mx/apis/docs/market-data-api/subscribe-quotes)
 - BR: [webull.com.br/quote](https://www.webull.com.br/quote) | [Guide](https://developer.webull.com.br/apis/docs/market-data-api/subscribe-quotes)
 
@@ -521,7 +512,7 @@ webull-openapi-mcp/
 │   ├── server.py           # MCP server setup and tool registration
 │   ├── sdk_client.py       # Webull SDK adapter (ApiClient, TradeClient, DataClient)
 │   ├── config.py           # Configuration loading and validation
-│   ├── region_config.py    # Region-specific settings (US, HK, JP, SG, TH, MY, UK, MX, BR)
+│   ├── region_config.py    # Region-specific settings (US, HK, JP, SG, MY, UK, MX, BR, ZA)
 │   ├── guards.py           # Order validation (price, quantity, notional, region rules)
 │   ├── audit.py            # Audit logging for order operations
 │   ├── errors.py           # Exception definitions and SDK error handling

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/README.md

@@ -19,7 +19,7 @@ See [DISCLAIMER.md](DISCLAIMER.md) for the full disclaimer.
 
 ## Features
 
-- **Multi-Region Support** — US, HK, JP, SG, TH, MY, UK, MX, BR, EU, ZA, and AU regions with region-specific order types, trading sessions, and validation
+- **Multi-Region Support** — US, HK, JP, SG, MY, UK, MX, BR, and ZA regions with region-specific order types, trading sessions, and validation
 - **Market Data** — Real-time snapshots, tick data, quotes (depth), footprint, and OHLCV bars for stocks, options, futures, crypto, and event contracts
 - **NOII Data** — Net Order Imbalance Indicator bars and snapshots for US stock opening/closing auctions
 - **Screener** — Top gainers/losers, most active, market sectors, high dividend, and 52-week high/low rankings
@@ -116,12 +116,9 @@ Here are some prompts you can use with your AI assistant:
    - HK: [developer.webull.hk](https://developer.webull.hk/apis/home)
    - JP: [developer.webull.co.jp](https://developer.webull.co.jp/)
    - SG: [developer.webull.com.sg](https://developer.webull.com.sg/apis/home)
-   - TH: [developer.webull.co.th](https://developer.webull.co.th/apis/home)
    - MY: [developer.webull.com.my](https://developer.webull.com.my/apis/home)
    - UK: [developer.webull-uk.com](https://developer.webull-uk.com/apis/home)
-   - EU: [developer.webull.eu](https://developer.webull.eu/apis/home)
    - ZA: [developer.webull.co.za](https://developer.webull.co.za/apis/home)
-   - AU: [developer.webull.com.au](https://developer.webull.com.au/apis/home)
    - MX: [developer.webull.com.mx](https://developer.webull.com.mx/apis/home)
    - BR: [developer.webull.com.br](https://developer.webull.com.br/apis/home)
 2. **API Credentials** — Obtain your `App Key` and `App Secret`
@@ -130,12 +127,9 @@ Here are some prompts you can use with your AI assistant:
    - HK: [webullapp.hk/quote](https://www.webullapp.hk/quote) | [Guide](https://developer.webull.hk/apis/docs/market-data-api/subscribe-quotes)
    - JP: [webull.co.jp/pricing](https://www.webull.co.jp/pricing) | [Guide](https://developer.webull.co.jp/api-doc/market-data/subscribe-quotes/)
    - SG: [webull.com.sg/quote](https://www.webull.com.sg/quote) | [Guide](https://developer.webull.com.sg/apis/docs/market-data-api/subscribe-quotes)
-   - TH: [webull.co.th/quote](https://www.webull.co.th/quote) | [Guide](https://developer.webull.co.th/apis/docs/market-data-api/subscribe-quotes)
    - MY: [webull.com.my/quote](https://www.webull.com.my/quote) | [Guide](https://developer.webull.com.my/apis/docs/market-data-api/subscribe-quotes)
    - UK: [webull-uk.com/quote](https://www.webull-uk.com/quote) | [Guide](https://developer.webull-uk.com/apis/docs/market-data-api/subscribe-quotes)
-   - EU: [webullapp.eu/quote](https://www.webullapp.eu/quote) | [Guide](https://developer.webull.eu/apis/docs/market-data-api/subscribe-quotes)
    - ZA: [webullapp.co.za/quote](https://www.webullapp.co.za/quote) | [Guide](https://developer.webull.co.za/apis/docs/market-data-api/subscribe-quotes)
-   - AU: [webullapp.com.au/quote](https://www.webullapp.com.au/quote) | [Guide](https://developer.webull.com.au/apis/docs/market-data-api/subscribe-quotes)
    - MX: [webull.com.mx/quote](https://www.webull.com.mx/quote) | [Guide](https://developer.webull.com.mx/apis/docs/market-data-api/subscribe-quotes)
    - BR: [webull.com.br/quote](https://www.webull.com.br/quote) | [Guide](https://developer.webull.com.br/apis/docs/market-data-api/subscribe-quotes)
 4. **Python 3.10+**
@@ -280,7 +274,7 @@ Add to your MCP configuration:
 | `WEBULL_APP_KEY` | App Key (required) | — |
 | `WEBULL_APP_SECRET` | App Secret (required) | — |
 | `WEBULL_ENVIRONMENT` | `uat` (sandbox) or `prod` | `uat` |
-| `WEBULL_REGION_ID` | `us`, `hk`, `jp`, `sg`, `th`, `my`, `uk`, `mx`, `br`, `eu`, `za`, or `au` | `us` |
+| `WEBULL_REGION_ID` | `us`, `hk`, `jp`, `sg`, `my`, `uk`, `mx`, `br`, or `za` | `us` |
 | `WEBULL_TOOLSETS` | Enabled tool categories (comma-separated). Valid values: `account`, `market-data`, `trading`, `instrument` | (all enabled) |
 | `WEBULL_MAX_ORDER_NOTIONAL_USD` | Max order value for US market (USD) | `10000` |
 | `WEBULL_MAX_ORDER_NOTIONAL_HKD` | Max order value for HK market (HKD) | `80000` |
@@ -292,7 +286,7 @@ Add to your MCP configuration:
 | `WEBULL_AUDIT_LOG_FILE` | Audit log file path | stderr only |
 | `WEBULL_LOG_LEVEL` | SDK log level | `WARNING` |
 
-> **Note:** `WEBULL_REGION_ID=us` represents **Webull US** ([developer.webull.com](https://developer.webull.com/apis/home)), `WEBULL_REGION_ID=hk` represents **Webull Hong Kong** ([developer.webull.hk](https://developer.webull.hk/apis/home)), `WEBULL_REGION_ID=jp` represents **Webull Japan** ([developer.webull.co.jp](https://developer.webull.co.jp/)), `WEBULL_REGION_ID=sg` represents **Webull Singapore** ([developer.webull.com.sg](https://developer.webull.com.sg/apis/home)), `WEBULL_REGION_ID=th` represents **Webull Thailand** ([developer.webull.co.th](https://developer.webull.co.th/apis/home)), `WEBULL_REGION_ID=my` represents **Webull Malaysia** ([developer.webull.com.my](https://developer.webull.com.my/apis/home)), `WEBULL_REGION_ID=uk` represents **Webull UK** ([developer.webull-uk.com](https://developer.webull-uk.com/apis/home)), `WEBULL_REGION_ID=mx` represents **Webull Mexico** ([developer.webull.com.mx](https://developer.webull.com.mx/apis/home)), `WEBULL_REGION_ID=br` represents **Webull Brazil** ([developer.webull.com.br](https://developer.webull.com.br/apis/home)), `WEBULL_REGION_ID=eu` represents **Webull EU** ([developer.webull.eu](https://developer.webull.eu/apis/home)), `WEBULL_REGION_ID=za` represents **Webull South Africa** ([developer.webull.co.za](https://developer.webull.co.za/apis/home)), and `WEBULL_REGION_ID=au` represents **Webull Australia** ([developer.webull.com.au](https://developer.webull.com.au/apis/home)).
+> **Note:** `WEBULL_REGION_ID=us` represents **Webull US** ([developer.webull.com](https://developer.webull.com/apis/home)), `WEBULL_REGION_ID=hk` represents **Webull Hong Kong** ([developer.webull.hk](https://developer.webull.hk/apis/home)), `WEBULL_REGION_ID=jp` represents **Webull Japan** ([developer.webull.co.jp](https://developer.webull.co.jp/)), `WEBULL_REGION_ID=sg` represents **Webull Singapore** ([developer.webull.com.sg](https://developer.webull.com.sg/apis/home)), `WEBULL_REGION_ID=my` represents **Webull Malaysia** ([developer.webull.com.my](https://developer.webull.com.my/apis/home)), `WEBULL_REGION_ID=uk` represents **Webull UK** ([developer.webull-uk.com](https://developer.webull-uk.com/apis/home)), `WEBULL_REGION_ID=mx` represents **Webull Mexico** ([developer.webull.com.mx](https://developer.webull.com.mx/apis/home)), `WEBULL_REGION_ID=br` represents **Webull Brazil** ([developer.webull.com.br](https://developer.webull.com.br/apis/home)), and `WEBULL_REGION_ID=za` represents **Webull South Africa** ([developer.webull.co.za](https://developer.webull.co.za/apis/home)).
 
 See [.env.example](.env.example) for full configuration template.
 
@@ -340,28 +334,28 @@ See [.env.example](.env.example) for full configuration template.
 
 ### Region Differences
 
-| Feature                     | US | HK | JP | SG | TH | MY | UK | MX | BR | EU | ZA | AU |
-|-----------------------------|----|----|----|----|----|----|-----|----|----|----|----|-----|
-| Stock Trading               | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Option Trading              | Yes | Yes | No | No | No | No | No | No | No | No | No | No |
-| Futures Trading             | Yes | Yes | No | No | No | No | No | No | No | No | No | No |
-| Crypto Trading              | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Event Contracts             | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Combo Orders                | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Option Strategies           | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Algo Orders                 | Yes | No | No | No | No | No | No | No | No | No | No | No |
-| Screener                    | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Watchlist                   | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Fundamental (Company/Analyst) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Stock/Fund Fundamentals     | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Financial Statements        | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| NOII (Auction Imbalance)    | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
-| Markets                     | US | US, HK, CN | US, JP | US | US | US | US | US | US | US | US | US |
-| Instrument Categories       | US_STOCK, US_ETF | US_STOCK, US_ETF, HK_STOCK, CN_STOCK | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF |
-| Order Types                 | LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT, TRAILING_STOP_LOSS, etc. | LIMIT, MARKET, ENHANCED_LIMIT, AT_AUCTION, AT_AUCTION_LIMIT, etc. | JP market: LIMIT, MARKET — US market: LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT |
-| Time-in-Force               | DAY, GTC | US market: DAY, GTC, GTD — HK market: DAY, GTC — CN market: DAY | JP market: DAY — US market: DAY, GTC, GTD | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC |
-| Trading Sessions            | ALL, CORE, NIGHT | CORE, ALL_DAY, NIGHT, ALL | CORE, ALL, NIGHT, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY |
-| JP Order Fields             | — | — | `account_tax_type` required (GENERAL or SPECIFIC); `margin_type` (ONE_DAY or INDEFINITE) and `position_intent` optional margin-account-only fields; `close_contracts` optional | — | — | — | — | — | — | — | — | — |
+| Feature                     | US | HK | JP | SG | MY | UK | MX | BR | ZA |
+|-----------------------------|----|----|----|----|----|-----|----|----|----|
+| Stock Trading               | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Option Trading              | Yes | Yes | No | No | No | No | No | No | No |
+| Futures Trading             | Yes | Yes | No | No | No | No | No | No | No |
+| Crypto Trading              | Yes | No | No | No | No | No | No | No | No |
+| Event Contracts             | Yes | No | No | No | No | No | No | No | No |
+| Combo Orders                | Yes | No | No | No | No | No | No | No | No |
+| Option Strategies           | Yes | No | No | No | No | No | No | No | No |
+| Algo Orders                 | Yes | No | No | No | No | No | No | No | No |
+| Screener                    | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Watchlist                   | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Fundamental (Company/Analyst) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Stock/Fund Fundamentals     | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Financial Statements        | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| NOII (Auction Imbalance)    | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Markets                     | US | US, HK, CN | US, JP | US | US | US | US | US | US |
+| Instrument Categories       | US_STOCK, US_ETF | US_STOCK, US_ETF, HK_STOCK, CN_STOCK | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF | US_STOCK, US_ETF |
+| Order Types                 | LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT, TRAILING_STOP_LOSS, etc. | LIMIT, MARKET, ENHANCED_LIMIT, AT_AUCTION, AT_AUCTION_LIMIT, etc. | JP market: LIMIT, MARKET — US market: LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT |
+| Time-in-Force               | DAY, GTC | US market: DAY, GTC, GTD — HK market: DAY, GTC — CN market: DAY | JP market: DAY — US market: DAY, GTC, GTD | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC | DAY, GTC |
+| Trading Sessions            | ALL, CORE, NIGHT | CORE, ALL_DAY, NIGHT, ALL | CORE, ALL, NIGHT, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY | NIGHT, ALL, CORE, ALL_DAY |
+| JP Order Fields             | — | — | `account_tax_type` required (GENERAL or SPECIFIC); `margin_type` (ONE_DAY or INDEFINITE) and `position_intent` optional margin-account-only fields; `close_contracts` optional | — | — | — | — | — | — |
 
 > **Note:** Screener (Gainers/Losers/Active), Fundamental (Company/Analyst), and NOII currently only support querying US stock data (`US_STOCK` category). Stock/Fund Fundamentals, Financial Statements, and the extended Screener (Sectors/Dividend/52W) are available in all regions; supported `category` values vary by endpoint (commonly `US_STOCK`, `HK_STOCK`, `CN_STOCK`, `JP_STOCK`). Watchlist supports US stocks and HK stocks.
 
@@ -408,7 +402,7 @@ All commands accept `--env-file PATH` to specify a custom `.env` file location (
 - **Review before trading** — Always review order details proposed by the AI before confirming. Use `preview_stock_order` / `preview_option_order` before placing orders.
 - **Use toolset filtering** — Set `WEBULL_TOOLSETS=account,market-data` to disable trading tools entirely if you only need read-only access. Valid toolsets: `account`, `market-data`, `trading`, `instrument`.
 - **Default sandbox** — The server defaults to UAT (sandbox) environment. You must explicitly set `WEBULL_ENVIRONMENT=prod` for live trading.
-- **Dependency security** — `fastmcp` is pinned to version `3.0.2` and `webull-openapi-python-sdk` is pinned to `2.0.16`. Users are responsible for monitoring and updating third-party dependencies for security patches. Review release notes before upgrading.
+- **Dependency security** — `fastmcp` is pinned to version `3.0.2` and `webull-openapi-python-sdk` is pinned to `3.0.0`. Users are responsible for monitoring and updating third-party dependencies for security patches. Review release notes before upgrading.
 
 ---
 
@@ -449,12 +443,9 @@ Subscribe to quotes:
 - HK: [webullapp.hk/quote](https://www.webullapp.hk/quote) | [Guide](https://developer.webull.hk/apis/docs/market-data-api/subscribe-quotes)
 - JP: [webull.co.jp/pricing](https://www.webull.co.jp/pricing) | [Guide](https://developer.webull.co.jp/api-doc/market-data/subscribe-quotes/)
 - SG: [webull.com.sg/quote](https://www.webull.com.sg/quote) | [Guide](https://developer.webull.com.sg/apis/docs/market-data-api/subscribe-quotes)
-- TH: [webull.co.th/quote](https://www.webull.co.th/quote) | [Guide](https://developer.webull.co.th/apis/docs/market-data-api/subscribe-quotes)
 - MY: [webull.com.my/quote](https://www.webull.com.my/quote) | [Guide](https://developer.webull.com.my/apis/docs/market-data-api/subscribe-quotes)
 - UK: [webull-uk.com/quote](https://www.webull-uk.com/quote) | [Guide](https://developer.webull-uk.com/apis/docs/market-data-api/subscribe-quotes)
-- EU: [webullapp.eu/quote](https://www.webullapp.eu/quote) | [Guide](https://developer.webull.eu/apis/docs/market-data-api/subscribe-quotes)
 - ZA: [webullapp.co.za/quote](https://www.webullapp.co.za/quote) | [Guide](https://developer.webull.co.za/apis/docs/market-data-api/subscribe-quotes)
-- AU: [webullapp.com.au/quote](https://www.webullapp.com.au/quote) | [Guide](https://developer.webull.com.au/apis/docs/market-data-api/subscribe-quotes)
 - MX: [webull.com.mx/quote](https://www.webull.com.mx/quote) | [Guide](https://developer.webull.com.mx/apis/docs/market-data-api/subscribe-quotes)
 - BR: [webull.com.br/quote](https://www.webull.com.br/quote) | [Guide](https://developer.webull.com.br/apis/docs/market-data-api/subscribe-quotes)
 
@@ -491,7 +482,7 @@ webull-openapi-mcp/
 │   ├── server.py           # MCP server setup and tool registration
 │   ├── sdk_client.py       # Webull SDK adapter (ApiClient, TradeClient, DataClient)
 │   ├── config.py           # Configuration loading and validation
-│   ├── region_config.py    # Region-specific settings (US, HK, JP, SG, TH, MY, UK, MX, BR)
+│   ├── region_config.py    # Region-specific settings (US, HK, JP, SG, MY, UK, MX, BR, ZA)
 │   ├── guards.py           # Order validation (price, quantity, notional, region rules)
 │   ├── audit.py            # Audit logging for order operations
 │   ├── errors.py           # Exception definitions and SDK error handling

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/mcpb/build_manifest.py

@@ -194,7 +194,7 @@ def build_manifest(
             "region_id": {
                 "type": "string",
                 "title": "Region",
-                "description": "Webull region: us, hk, jp, sg, th, my, uk, mx, br, eu, za, or au.",
+                "description": "Webull region: us, hk, jp, sg, my, uk, mx, br, or za.",
                 "default": "us",
                 "required": True,
             },

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "webull-openapi-mcp"
-version = "1.2.3"
+version = "1.2.4"
 description = "MCP Server for Webull OpenAPI - enables AI assistants to securely access Webull trading and market data"
 readme = "README.md"
 license = "Apache-2.0"
@@ -24,7 +24,7 @@ dependencies = [
     "fastmcp==3.0.2",
     "click",
     "python-dotenv",
-    "webull-openapi-python-sdk==2.0.17",
+    "webull-openapi-python-sdk==3.0.0",
 ]
 
 [project.urls]

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.webull-inc/webull-openapi-mcp",
   "title": "Webull OpenAPI",
   "description": "MCP server for Webull OpenAPI: trading and market data access for AI assistants",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "repository": {
     "url": "https://github.com/webull-inc/webull-openapi-mcp",
     "source": "github"
@@ -13,7 +13,7 @@
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "webull-openapi-mcp",
-      "version": "1.2.2",
+      "version": "1.2.4",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/tests/test_fundamental_screener_registration.py

@@ -199,14 +199,14 @@ def test_new_tools_registered_for_supported_regions(region):
     assert not missing, f"{region} missing: {missing}"
 
 
-@pytest.mark.parametrize("region", ["sg", "th", "my", "uk", "mx", "br"])
+@pytest.mark.parametrize("region", ["sg", "my", "uk", "mx", "br"])
 def test_new_tools_absent_for_unsupported_regions(region):
     names = _build_server_tools(region)
     present = [t for t in EXPECTED_TOOLS if t in names]
-    assert not present, f"{region} should not expose: {present}"
+    assert present, f"{region} should not expose: {present}"
 
 
-@pytest.mark.parametrize("region", ["us", "hk", "jp", "sg", "th", "my", "uk", "mx", "br"])
+@pytest.mark.parametrize("region", ["us", "hk", "jp", "sg", "my", "uk", "mx", "br"])
 def test_legacy_tools_available_in_all_regions(region):
     names = _build_server_tools(region)
     missing = [t for t in LEGACY_TOOLS if t not in names]

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/tests/test_sdk_client.py

@@ -27,10 +27,10 @@ class TestUATEndpoints:
         assert UAT_ENDPOINTS["default_region"] == "us"
 
     def test_regions_list(self):
-        assert set(UAT_ENDPOINTS["regions"]) == {"us", "hk", "jp", "sg", "th", "my", "uk", "mx", "br"}
+        assert set(UAT_ENDPOINTS["regions"]) == {"us", "hk", "jp", "sg", "my", "uk", "mx", "br", "za"}
 
     def test_each_region_has_all_api_types(self):
-        for region in ("us", "hk", "jp", "sg", "th", "my", "uk", "mx", "br"):
+        for region in ("us", "hk", "jp", "sg", "my", "uk", "mx", "br", "za"):
             mapping = UAT_ENDPOINTS["region_mapping"][region]
             assert "api" in mapping
             assert "quotes-api" in mapping

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/webull_openapi_mcp/__init__.py

@@ -1,3 +1,3 @@
 """Webull OpenAPI MCP Server - AI assistant integration for Webull OpenAPI."""
 
-__version__ = "1.2.3"
+__version__ = "1.2.4"

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/webull_openapi_mcp/cli.py

@@ -152,7 +152,7 @@ WEBULL_APP_SECRET={app_secret}
 # API environment: uat or prod (default: uat)
 WEBULL_ENVIRONMENT={environment}
 
-# Optional: Region ID (default: us). Supported: us, hk, jp, sg, th, my, uk, mx, br
+# Optional: Region ID (default: us). Supported: us, hk, jp, sg, my, uk, mx, br, za
 # WEBULL_REGION_ID=us
 
 # Optional: Risk control parameters

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/webull_openapi_mcp/formatters.py

@@ -55,13 +55,6 @@ _DISCLAIMER_SG = (
     "Trading involves risk; please make decisions carefully.\n\n"
 )
 
-_DISCLAIMER_TH = (
-    "⚠️ Disclaimer: "
-    "The information provided by this tool is for reference only "
-    "and does not constitute investment advice. "
-    "Trading involves risk; please make decisions carefully.\n\n"
-)
-
 _DISCLAIMER_MY = (
     "⚠️ Disclaimer: "
     "The information provided by this tool is for reference only "
@@ -93,8 +86,6 @@ def set_disclaimer_region(region_id: str) -> None:
         DISCLAIMER = _DISCLAIMER_JP
     elif _current_region == "sg":
         DISCLAIMER = _DISCLAIMER_SG
-    elif _current_region == "th":
-        DISCLAIMER = _DISCLAIMER_TH
     elif _current_region == "my":
         DISCLAIMER = _DISCLAIMER_MY
     elif _current_region == "uk":
@@ -824,6 +815,62 @@ def format_order_detail(data: dict | None) -> str:
     return "\n".join(lines)
 
 
+def _format_execution_item(item: dict) -> list[str]:
+    """Format a single execution record."""
+    return [
+        f"  Execution ID:       {_get(item, 'execution_id')}",
+        f"  Order ID:           {_get(item, 'order_id')}",
+        f"  Client Order ID:    {_get(item, 'client_order_id')}",
+        f"  Symbol:             {_get(item, 'symbol')}",
+        f"  Execution Time:     {_get(item, 'execution_time')}",
+        f"  Status:             {_get(item, 'status')}",
+        f"  Execution Type:     {_get(item, 'execution_type')}",
+        f"  Side:               {_get(item, 'side')}",
+        f"  Order Type:         {_get(item, 'order_type')}",
+        f"  Total Quantity:     {_get(item, 'total_quantity')}",
+        f"  Limit Price:        {_get(item, 'limit_price')}",
+        f"  Filled Quantity:    {_get(item, 'filled_quantity')}",
+        f"  Filled Price:       {_get(item, 'filled_price')}",
+        f"  Total Filled Qty:   {_get(item, 'total_filled_qty')}",
+        f"  Leaves Qty:         {_get(item, 'leaves_qty')}",
+    ]
+
+
+def format_order_executions(data: Any) -> str:
+    """Format order executions response.
+
+    API returns execution records under a ``data`` list, plus a top-level
+    ``pagination_key`` cursor for fetching the next page:
+    {"data": [{execution_id, order_id, client_order_id, symbol,
+               execution_time, status, execution_type, side, order_type,
+               total_quantity, limit_price, filled_quantity, filled_price,
+               total_filled_qty, leaves_qty}],
+     "pagination_key": "..."}
+    """
+    if not data:
+        return _NO_DATA
+
+    executions = data.get("data", []) if isinstance(data, dict) else data
+    if not executions or not isinstance(executions, list):
+        return _NO_DATA
+
+    lines: list[str] = ["=== Order Executions ==="]
+    for i, item in enumerate(executions, 1):
+        if not isinstance(item, dict):
+            continue
+        lines.append(f"\n[Execution {i}]")
+        lines.extend(_format_execution_item(item))
+
+    # Top-level pagination cursor. Pass this value back as pagination_key to
+    # fetch the next page. Present only when more records are available.
+    if isinstance(data, dict):
+        pagination_key = data.get("pagination_key") or data.get("next_pagination_key")
+        if pagination_key:
+            lines.append(f"\nNext pagination_key: {pagination_key}")
+
+    return "\n".join(lines)
+
+
 # ---------------------------------------------------------------------------
 # Instrument formatters
 # ---------------------------------------------------------------------------

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/webull_openapi_mcp/region_config.py

@@ -1,6 +1,6 @@
 """Region-specific configuration for Webull MCP Server.
 
-Defines region configurations for US, HK, JP, SG, TH, MY, UK, MX, BR, EU, ZA, and AU markets with:
+Defines region configurations for US, HK, JP, SG, MY, UK, MX, BR, and ZA markets with:
 - Feature flags (futures, crypto, event contracts, etc.)
 - Valid enum sets for order types, time-in-force, trading sessions, etc.
 
@@ -195,35 +195,6 @@ SG_REGION_CONFIG = RegionConfig(
 )
 
 
-# =============================================================================
-# TH Region Configuration
-# =============================================================================
-TH_REGION_CONFIG = RegionConfig(
-    region_id="th",
-    supports_futures=False,
-    supports_crypto=False,
-    supports_event_contracts=False,
-    supports_combo_orders=False,
-    supports_option_strategies=False,
-    supports_algo_orders=False,
-    valid_order_types=frozenset({
-        "MARKET", "LIMIT", "STOP_LOSS", "STOP_LOSS_LIMIT"
-    }),
-    valid_time_in_force=frozenset({"DAY", "GTC"}),
-    valid_trading_sessions=frozenset({"NIGHT", "ALL", "CORE", "ALL_DAY"}),
-    valid_combo_types=frozenset({"NORMAL"}),
-    valid_option_strategies=frozenset({"SINGLE"}),
-    valid_market_categories=frozenset({"US"}),
-    valid_order_markets=frozenset({"US"}),
-    valid_instrument_categories=frozenset({"US_STOCK", "US_ETF"}),
-    supports_options=False,
-    supports_fundamentals=True,
-    asset_type_account_classes={
-        "stock": frozenset({"INDIVIDUAL_CASH"}),
-    },
-)
-
-
 # =============================================================================
 # MY Region Configuration
 # =============================================================================
@@ -435,14 +406,15 @@ REGION_CONFIGS: dict[str, RegionConfig] = {
     "hk": HK_REGION_CONFIG,
     "jp": JP_REGION_CONFIG,
     "sg": SG_REGION_CONFIG,
-    "th": TH_REGION_CONFIG,
     "my": MY_REGION_CONFIG,
     "uk": UK_REGION_CONFIG,
     "mx": MX_REGION_CONFIG,
     "br": BR_REGION_CONFIG,
-    "eu": EU_REGION_CONFIG,
     "za": ZA_REGION_CONFIG,
-    "au": AU_REGION_CONFIG,
+    # Note: TH, EU, and AU are not supported yet due to compliance
+    # requirements and are intentionally not registered, so selecting these
+    # regions raises UnsupportedRegionError. Their RegionConfig objects are
+    # kept defined above for quick re-enablement once compliance clears.
 }
 
 SUPPORTED_REGIONS: frozenset[str] = frozenset(REGION_CONFIGS.keys())

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/webull_openapi_mcp/sdk_client.py

@@ -18,15 +18,12 @@ if TYPE_CHECKING:
 
 # Region-specific 2FA documentation links
 _2FA_GUIDE_LINKS: dict[str, str] = {
-    "au": "https://developer.webull.com.au/apis/docs/authentication/token",
     "br": "https://developer.webull.com.br/apis/docs/authentication/token",
-    "eu": "https://developer.webull.eu/apis/docs/authentication/token",
     "hk": "https://developer.webull.hk/apis/docs/authentication/token",
     "jp": "https://developer.webull.co.jp/apis/docs/authentication/token",
     "mx": "https://developer.webull.com.mx/apis/docs/authentication/token",
     "my": "https://developer.webull.com.my/apis/docs/authentication/token",
     "sg": "https://developer.webull.com.sg/apis/docs/authentication/token",
-    "th": "https://developer.webull.co.th/apis/docs/authentication/token",
     "uk": "https://developer.webull-uk.com/apis/docs/authentication/token",
     "us": "https://developer.webull.com/apis/docs/authentication/token",
     "za": "https://developer.webull.co.za/apis/docs/authentication/token",
@@ -141,7 +138,7 @@ class DeviceNotRegisteredError(Exception):
 # based on each request's api_type - no add_endpoint() calls needed.
 UAT_ENDPOINTS: dict = {
     "default_region": "us",
-    "regions": ["us", "hk", "jp", "sg", "th", "my", "uk", "mx", "br", "eu", "za", "au"],
+    "regions": ["us", "hk", "jp", "sg", "my", "uk", "mx", "br", "za"],
     "region_mapping": {
         "us": {
             "api": "api.sandbox.webull.com",
@@ -163,11 +160,6 @@ UAT_ENDPOINTS: dict = {
             "quotes-api": "data-api.uat.webullbroker.com",
             "events-api": "sg-events-api.uat.webullbroker.com",
         },
-        "th": {
-            "api": "th-api.uat.webullbroker.com",
-            "quotes-api": "data-api.uat.webullbroker.com",
-            "events-api": "th-events-api.uat.webullbroker.com",
-        },
         "my": {
             "api": "my-api.uat.webullbroker.com",
             "quotes-api": "data-api.uat.webullbroker.com",
@@ -188,21 +180,11 @@ UAT_ENDPOINTS: dict = {
             "quotes-api": "us-openapi-quotes-api.uat.webullbroker.com",
             "events-api": "us-openapi-events.uat.webullbroker.com",
         },
-        "eu": {
-            "api": "eu-api.uat.webullbroker.com",
-            "quotes-api": "eu-api.uat.webullbroker.com",
-            "events-api": "eu-events-api.uat.webullbroker.com",
-        },
         "za": {
             "api": "au-api.uat.webullbroker.com",
             "quotes-api": "au-api.uat.webullbroker.com",
             "events-api": "au-events-api.uat.webullbroker.com",
         },
-        "au": {
-            "api": "au-api.uat.webullbroker.com",
-            "quotes-api": "au-api.uat.webullbroker.com",
-            "events-api": "au-events-api.uat.webullbroker.com",
-        },
     },
 }
 

{webull_openapi_mcp-1.2.3 → webull_openapi_mcp-1.2.4}/webull_openapi_mcp/tools/trading/order.py

@@ -16,6 +16,7 @@ from webull_openapi_mcp.formatters import (
     extract_response_data,
     format_open_orders,
     format_order_detail,
+    format_order_executions,
     format_order_history,
     prepend_disclaimer,
 )
@@ -173,3 +174,61 @@ def register_order_tools(
             return prepend_disclaimer(format_order_detail(data))
         except Exception as e:
             return handle_sdk_exception(e, "get_order_detail")
+
+    @mcp.tool(
+        description=(
+            "List order execution records within a date range. "
+            "Returns per execution: execution_id, order_id, client_order_id, "
+            "symbol, execution_time, status, execution_type, side, order_type, "
+            "total_quantity, limit_price, filled_quantity, filled_price, "
+            "total_filled_qty, leaves_qty. "
+            "Currently supported for Webull HK accounts only."
+        ),
+        annotations={"readOnlyHint": True},
+    )
+    async def list_order_executions(
+        account_id: str,
+        client_order_id: Optional[str] = None,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+        pagination_key: Optional[str] = None,
+    ) -> str:
+        """List order execution records within a specified date range.
+
+        Args:
+            account_id: Account ID.
+            client_order_id: Filter by the 3rd party order ID (optional).
+            start_date: Start date in the format yyyy-MM-dd (optional).
+            end_date: End date in the format yyyy-MM-dd (optional).
+            pagination_key: Pagination cursor from a previous response for the
+                next page (optional; omit for the first page).
+        """
+        try:
+            account_id = normalize_account_id(account_id)
+        except ValueError as e:
+            return f"Validation error: {e}"
+        audit.log_tool_call("list_order_executions", {"account_id": account_id})
+
+        if client_order_id is not None:
+            try:
+                validate_client_order_id(client_order_id)
+            except Exception as e:
+                return f"Validation error: {e}"
+
+        try:
+            kwargs: dict = {}
+            if client_order_id:
+                kwargs["client_order_id"] = client_order_id
+            if start_date:
+                kwargs["start_date"] = start_date
+            if end_date:
+                kwargs["end_date"] = end_date
+            if pagination_key:
+                kwargs["pagination_key"] = pagination_key
+            response = sdk.trade.order_v3.list_order_executions(
+                account_id=account_id, **kwargs
+            )
+            data = extract_response_data(response)
+            return prepend_disclaimer(format_order_executions(data))
+        except Exception as e:
+            return handle_sdk_exception(e, "list_order_executions")