longbridge · hogan-yuan · Jul 7, 2026 · Jul 7, 2026 · Jul 7, 2026 · Jul 7, 2026
diff --git a/.gitignore b/.gitignore
@@ -43,3 +43,8 @@ docs/superpowers
 # generated at build time by fetch-mcp-tools plugin
 docs/.vitepress/data/mcp-tools.json
 docs/.vitepress/.temp/
+
+# Stray submodule directories
+longbridge-terminal/
+openapi/
+openapi-go/
diff --git a/docs/en/docs/account/dca/calc_date.md b/docs/en/docs/account/dca/calc_date.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Calculate the next projected trade date for given DCA plan parameters.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/check_support.md b/docs/en/docs/account/dca/check_support.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Check whether the given securities support DCA recurring investment.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/create_dca.md b/docs/en/docs/account/dca/create_dca.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Create a new recurring investment plan for a security.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/dca_history.md b/docs/en/docs/account/dca/dca_history.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Get the execution history for a specific DCA plan including trade dates, amounts, and prices.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/dca_stats.md b/docs/en/docs/account/dca/dca_stats.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Get DCA statistics summary including total invested amount and profit/loss.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/list_dca.md b/docs/en/docs/account/dca/list_dca.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Get all recurring investment (DCA) plans for the current user.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/pause_dca.md b/docs/en/docs/account/dca/pause_dca.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Temporarily pause a DCA plan. The plan can be resumed later.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/resume_dca.md b/docs/en/docs/account/dca/resume_dca.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Resume a previously paused DCA plan.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/set_reminder.md b/docs/en/docs/account/dca/set_reminder.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Set the advance reminder time for DCA plans. Supported values: `1`, `6`, or `12` hours.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/stop_dca.md b/docs/en/docs/account/dca/stop_dca.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Permanently stop a DCA plan. This action cannot be undone.
 
 <CliCommand>

diff --git a/docs/en/docs/account/dca/update_dca.md b/docs/en/docs/account/dca/update_dca.md
@@ -10,6 +10,10 @@ highlight_theme: ''
 headingLevel: 2
 ---
 
+:::warning Not for Longbridge US Accounts
+This method requires an AP data-center account (HK / Singapore). US data-center accounts will receive a region restriction error. AP accounts can call this method with any supported symbol, including US stocks.
+:::
+
 Pause or resume an existing recurring investment plan.
 
 <CliCommand>

diff --git a/docs/en/docs/changelog.md b/docs/en/docs/changelog.md
@@ -6,6 +6,21 @@ sidebar_position: 7
 sidebar_icon: newspaper
 ---
 
+## 2026-07-07
+
+### SDK v4.4.0
+
+- **US market APIs** — 14 new methods across `FundamentalContext` (9), `QuoteContext` (1), `TradeContext` (4); all US data-center only
+
+### CLI v0.25.0
+
+- **US market routing** — `company`, `valuation`, `financial-report`, `consensus`, `dividend`, `order`, `positions` now route to US APIs automatically for US data-center accounts
+- **New `etf-docs` command** — list regulatory documents (prospectus, fact sheets) for US ETFs
+- **New `financial-report key-metrics` subcommand** — key financial metrics for US stocks (annual/quarterly)
+- **New `profit-analysis realized` subcommand** — realized P&L breakdown by asset category for US accounts (stock/option/crypto)
+- **New `order --status` / `--action` flags** — filter US order history by status and side
+- **New `order detail --attached` flag** — show attached child order for US accounts
+
 ## 2026-06-25
 
 ### SDK v4.3.3

diff --git a/docs/en/docs/cli/account/dca.md b/docs/en/docs/cli/account/dca.md
@@ -4,6 +4,10 @@ sidebar_label: 'dca'
 sidebar_position: 10
 ---
 
+:::warning Not for Longbridge US Accounts
+This command requires an AP data-center account (HK / Singapore). US data-center accounts are not supported. AP accounts can use this command with any supported symbol, including US stocks.
+:::
+
 # longbridge dca
 
 Recurring investment — automatically invest a fixed amount at regular intervals. Create and manage plans that execute stock purchases on a daily, weekly, fortnightly, or monthly schedule. Track trade history, monitor cumulative profit, and check upcoming trade dates.

diff --git a/docs/en/docs/cli/account/profit-analysis.md b/docs/en/docs/cli/account/profit-analysis.md
@@ -83,3 +83,24 @@ Shows stock P&L filtered by market with pagination support.
 ## Requirements
 
 OAuth account permission required. See the [account permission setup](/docs/trade/) guide.
+
+## Subcommands
+
+### `realized` — Realized P&L (US accounts)
+
+```bash
+longbridge profit-analysis realized
+longbridge profit-analysis realized --category stock
+longbridge profit-analysis realized --category option --currency USD
+```
+
+Returns realized profit and loss breakdown by asset category for US accounts.
+
+:::warning Longbridge US Accounts
+`profit-analysis realized` is only available for US data-center accounts.
+:::
+
+| Option | Description | Default |
+| ------ | ----------- | ------- |
+| `--category` | Asset category: `all` \| `stock` \| `option` \| `crypto` | all |
+| `--currency` | Settlement currency | USD |
diff --git a/docs/en/docs/cli/fundamentals/company.md b/docs/en/docs/cli/fundamentals/company.md
@@ -42,3 +42,7 @@ Shows key company information including founding date, number of employees, IPO
 ```bash
 longbridge company TSLA.US --format json
 ```
+
+:::info US Accounts
+For `.US` symbols on US data-center accounts, `company` routes to the US company overview API automatically.
+:::
diff --git a/docs/en/docs/cli/fundamentals/consensus.md b/docs/en/docs/cli/fundamentals/consensus.md
@@ -56,3 +56,7 @@ longbridge consensus TSLA.US --format json
 ```
 
 Each `details` entry includes the metric key, the consensus estimate value, and whether the actual result has already been released. `current_index` in the full response indicates which period in the list is the current one.
+
+:::info US Accounts
+For `.US` symbols on US data-center accounts, `consensus` routes to the US analyst consensus API automatically.
+:::
diff --git a/docs/en/docs/cli/fundamentals/dividend.md b/docs/en/docs/cli/fundamentals/dividend.md
@@ -66,3 +66,7 @@ longbridge dividend AAPL.US --format json
 ```
 
 Returns structured JSON with `ex_date`, `payment_date`, `record_date`, and a `desc` field containing the dividend amount description (e.g., `"Dividend: USD 0.26/share"`) — suitable for piping into scripts or tracking tools.
+
+:::info US Accounts
+For US data-center accounts: `.US` ETF symbols route to the US ETF dividend API; `.US` stock symbols route to the US company dividends API.
+:::
diff --git a/docs/en/docs/cli/fundamentals/etf-docs.md b/docs/en/docs/cli/fundamentals/etf-docs.md
@@ -0,0 +1,49 @@
+---
+title: 'etf-docs'
+sidebar_label: 'etf-docs'
+sidebar_position: 21
+---
+
+# longbridge etf-docs
+
+List regulatory documents for a US ETF — prospectus, fact sheets, and other filings.
+
+:::warning Longbridge US Accounts
+This command is only available for US data-center accounts.
+:::
+
+## Basic Usage
+
+```bash
+longbridge etf-docs IVV.US
+```
+
+```
+Name
+----
+iShares Core S&P 500 ETF Prospectus
+iShares Core S&P 500 ETF Statement of Additional Information
+iShares Core S&P 500 ETF Annual Report
+...
+```
+
+## Examples
+
+### List ETF documents
+
+<CliCommand>
+longbridge etf-docs IVV.US
+longbridge etf-docs SPY.US
+</CliCommand>
+
+### Limit number of results
+
+```bash
+longbridge etf-docs IVV.US --limit 5
+```
+
+## Options
+
+| Option | Description | Default |
+| ------ | ----------- | ------- |
+| `--limit` | Maximum number of documents to return | 10 |
diff --git a/docs/en/docs/cli/fundamentals/financial-report.md b/docs/en/docs/cli/fundamentals/financial-report.md
@@ -96,3 +96,26 @@ longbridge financial-report snapshot TSLA.US --report qf --year 2025 --period 4
 ```
 
 Use `--report qf --year <YEAR> --period <1-4>` to retrieve a specific quarter.
+
+### Key financial metrics (US accounts)
+
+```bash
+longbridge financial-report key-metrics AAPL.US
+longbridge financial-report key-metrics AAPL.US --report quarterly
+```
+
+Returns key financial indicators for US stocks: revenue, net income, EPS, margins, and growth rates.
+
+:::warning Longbridge US Accounts
+`financial-report key-metrics` is only available for US data-center accounts.
+:::
+
+| Option | Description | Default |
+| ------ | ----------- | ------- |
+| `--report` | Reporting period: `annual` \| `quarterly` | annual |
+
+:::info US Accounts
+For `.US` symbols on US data-center accounts, omitting `--kind` returns a financial overview via the US API.
+
+To get detailed income statement / balance sheet / cash flow for US stocks, use the [`financial-statement`](/docs/cli/fundamentals/financial-statement) command instead.
+:::
diff --git a/docs/en/docs/cli/fundamentals/financial-statement.md b/docs/en/docs/cli/fundamentals/financial-statement.md
@@ -8,6 +8,10 @@ sidebar_position: 3
 
 Fetch a fully detailed, line-item financial statement — income statement, balance sheet, or cash flow — for any public company.
 
+
+:::info US Accounts
+For `.US` symbols on US data-center accounts, `financial-statement` calls `us_financial_statement()` — the US-specific detailed statement API.
+:::
 ## Basic Usage
 
 ```bash

diff --git a/docs/en/docs/cli/fundamentals/macrodata.md b/docs/en/docs/cli/fundamentals/macrodata.md
@@ -26,7 +26,7 @@ longbridge macrodata
 ```
 Total: 619
 Code   Name              Category    Country   Frequency   Source
-62267  Non-Farm Payroll  Employment  US        Monthly     Bureau of Labor Statistics
+61744  Non-Farm Payroll  Employment  US        Monthly     Bureau of Labor Statistics
 ...
 ```
 
@@ -56,7 +56,7 @@ longbridge macrodata --country US --limit 50 --page 2
 ### Historical releases for a specific indicator
 
 ```bash
-longbridge macrodata 62267
+longbridge macrodata 61744
 ```
 
 ```
@@ -71,7 +71,7 @@ Period      Actual   Forecast  Previous  Revised   Unit
 ### Filter history by date range
 
 ```bash
-longbridge macrodata 62267 --start 2024-01-01 --end 2024-12-31
+longbridge macrodata 61744 --start 2024-01-01 --end 2024-12-31
 ```
 
 ### JSON output for AI / scripting
@@ -81,7 +81,7 @@ longbridge macrodata 62267 --start 2024-01-01 --end 2024-12-31
 longbridge macrodata --format json
 
 # History as JSON
-longbridge macrodata 62267 --format json
+longbridge macrodata 61744 --format json
 ```
 
 **List JSON structure:**
@@ -94,7 +94,7 @@ longbridge macrodata 62267 --format json
   "has_more": true,
   "list": [
     {
-      "indicator_code": "62267",
+      "indicator_code": "61744",
       "country": "US",
       "name": "Non-Farm Payroll",
       "periodicity": "Monthly",
@@ -113,7 +113,7 @@ longbridge macrodata 62267 --format json
   "limit": 20,
   "has_more": true,
   "info": {
-    "indicator_code": "62267",
+    "indicator_code": "61744",
     "country": "US",
     "name": "Non-Farm Payroll",
     "periodicity": "Monthly",

diff --git a/docs/en/docs/cli/fundamentals/valuation.md b/docs/en/docs/cli/fundamentals/valuation.md
@@ -77,3 +77,7 @@ longbridge valuation TSLA.US --history --indicator pb --format json
 ```
 
 The `desc` field provides a human-readable summary of how the current valuation compares to historical range and industry peers. The `list` array contains the time series data points.
+
+:::info US Accounts
+For `.US` symbols on US data-center accounts, `valuation` routes to the US valuation overview API automatically.
+:::
diff --git a/docs/en/docs/cli/market-data/broker-holding.md b/docs/en/docs/cli/market-data/broker-holding.md
@@ -4,6 +4,10 @@ sidebar_label: 'broker-holding'
 sidebar_position: 15
 ---
 
+:::warning Not for Longbridge US Accounts
+This command requires an AP data-center account (HK / Singapore). US data-center accounts are not supported. AP accounts can use this command with any supported symbol, including US stocks.
+:::
+
 # longbridge broker-holding
 
 View broker holding positions for HK-listed stocks — top buyers/sellers, full detail list, and daily history per broker.