# Release Notes ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) - **[Chat with LongbridgeAI in the terminal](/docs/cli/ai)** — the new `longbridge ai` command opens a full-screen chat: answers stream in as Markdown with terminal-drawn charts, box-drawn tables, syntax-highlighted code and live quote cards. A title-bar ticker follows every security the conversation mentions (click one for a full quote card), slash commands cover `/new` `/retry` `/copy` `/export` `/quote` `/resume` `/settings` `/agent` `/login`, and conversations are stored on your account — a chat started in the terminal continues wherever else you use LongbridgeAI - **[New `serve` command — embed the Longbridge API in your own app](/docs/cli/serve)** — `longbridge serve` keeps one authenticated process alive and speaks JSON-RPC 2.0 over stdin/stdout: every `quote.*` and `trade.*` method, `api.get` / `api.post` passthrough to any REST endpoint, and `quote.subscribe` for live quote / depth / broker / trade pushes. Desktop widgets, bar plugins and dashboards stop paying region detection, token load and WebSocket connect on every poll — and can see the ticks between polls. Payloads are the raw OpenAPI shapes, not the CLI's `--format json` rendering - **New `grid` command group — grid trading** — `longbridge grid` lists grid orders (`--ids`, `--symbol`, `--status`), plus `submit`, `replace`, `detail`, `triggers`, `cancel`, `suspend`, `restart`, `info` and `questionnaire`. `submit` / `replace` share one rule flag set: price range and base price, `--trigger-type percent|spread` with `--trigger-up` / `--trigger-down`, per-side quantities and order types, TIF, and what happens when the price leaves the range — with `--dry-run` to validate and print the rule without submitting it - **Reworked TUI chrome** — primary tabs are pills, and the shortcut hints no longer overflow: they take the space the tabs leave, shed the least important first, and are clickable (Settings and Help never go). Portfolio and Orders gain a right-hand detail panel that follows the selection; the stock screen drops its Quote/News tab strip so the article pane can wrap, scroll and open on longbridge.com, and docks the news list beside the quote panel when both fit. Clicking a shortcut hint now runs the same action its key does, and the footer's index quotes carry click targets that follow the text rather than a fixed third. The settings modal is a real two-column grid, with clickable chips and `←`/`→` stepping values in either direction, and it moves off `Ctrl+,` (which conflicts on some platforms) to `,` - **Fix: intraday charts rendered as a dot texture** — the area fill is now shade blocks in the line's own color and the volume bars are solid, instead of braille (which can only set a foreground). Two bugs behind it are fixed too: the ANSI parser read only the first parameter of an SGR escape, dropping any sequence that set more than one attribute; and the chart info bars hardcoded green/red instead of following the up/down color setting — one of them inverted in the default mode - **`news detail` now returns structured data** — the article is read from Longbridge's own content service instead of being scraped off the web page, so title, published time, author and related securities come back as proper fields alongside the Markdown body; `--format json` prints the full item ### [v0.27.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.27.0) - **[Use LongbridgeAI over ACP](/docs/cli/acp)** — The new `longbridge acp` command runs [LongbridgeAI](https://longbridge.com/ai) as an [Agent Client Protocol](https://agentclientprotocol.com/) (ACP) compatible agent. You can now look up live market data, analyze company fundamentals, and interpret account positions from compatible client applications; see the ACP guide for setup - **New `agent` commands for LongbridgeAI** — `agent workspaces` lists AI workspaces; `agent list` discovers chat-capable agents (`--workspace`, `--name`; `--all` includes workflow agents); `agent chat chatbot "…"` holds a conversation over SSE (`--stream` for live tokens — the public `chatbot` agent is usable by any account), with `agent chat chatbot "…"` for multi-turn follow-ups; `agent continue chatbot ` resumes an interrupted run (`--answer` / `--answers-json`); and `agent --skill` prints the agent skill doc for AI harnesses ### [v0.26.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.26.0) - **New TUI settings modal (`Ctrl+,`)** — first setting is up/down colors (red-up vs green-up); applied instantly and remembered across restarts in `~/.longbridge/terminal.json` - **Context-aware shortcut hints and mouse scrolling in the TUI** — the top bar now lists only the keys available on the current screen, and the scroll wheel moves the selection in the watchlist / orders / news / portfolio lists - **Refreshed TUI visuals** — rounded borders on panels and modals, bold titles and table headers, and a stacked asset-distribution bar on the Portfolio screen; all drawn in the terminal's own palette - **Access point no longer gets stuck on China Mainland** — the region is now decided by the country geotest reports rather than by whether it merely responds, and is re-checked every 6 hours, so a client that has left China Mainland stops being routed to `longbridge.cn`. `check` re-detects on every run, measures both access points and switches to whichever is decisively better; a connection failure against `.cn` now explains how to override the region - **Fix: `ipo calendar` returned no data** — the upstream aggregation endpoint began returning an empty summary for every account; the command is rebuilt on the data sources that still work - **Fix: clearer error for US option quotes** — `option quote` now explains that the "OPRA US Options" OpenAPI market-data permission is required and links to pricing, instead of surfacing a bare `301604` - **Fix: `ipo detail` degrades gracefully** — timeline, eligibility and holdings are treated as optional enrichment, so the core profile still prints when an auxiliary endpoint is unavailable (`null` in JSON, warnings under `-v`) ### [v0.25.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.25.0) - **US data-center support** — `auth login` (device flow and `--auth-code`) can now authorize US accounts, and every authenticated request routes to the data center matching the token; `auth status` shows the active DC region - **US account and fundamentals coverage** — US tokens automatically route 14 commands (`positions`, `order`, `company`, `valuation`, `financial-report`, `financial-statement`, `consensus`, `dividend`, etc.) to US-specific endpoints, plus new `profit-analysis realized` and `financial-report key-metrics` subcommands - **`quant run` moved to the v2 API with Navi support** — new `--language navi|pine` flag (Navi is the default); chart rendering handles both the v1 and v2 payload shapes - **US market routing** — `company`, `valuation`, `financial-report`, `consensus`, `dividend`, `order`, `positions` auto-route to US APIs for US data-center accounts - **New `etf-docs` command** — list ETF regulatory documents (prospectus, fact sheets, annual reports) for US ETFs; `--limit` controls how many to return - **New `financial-report key-metrics` subcommand** — key financial indicators for US stocks; supports `--report annual|quarterly` - **New `profit-analysis realized` subcommand** — realized P&L by asset category (`--category stock|option|crypto`); US accounts only - **New order flags** — `--status pending|history|all` and `--action buy|sell` filter US order history; `order detail --attached` fetches child orders ### [v0.24.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.24.0) - **New `macrodata` command** — Browse 400+ macrodata indicators across US/HK/CN/EU/JP/SG; list mode with optional `--country` filter, history mode for a specific indicator code with `--start`/`--end` date range; `--format json` for AI/scripting workflows ### [v0.23.2](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.23.2) - **Local-time date parsing for CLI arguments** — date-only and legacy minute-resolution datetime inputs are interpreted in the user's local timezone before API calls; RFC 3339 datetime inputs are also supported - **Fix: `market-status` US post-market label** — US status code `203` now displays as `Post-Market` instead of `Trading`, so after-hours market state is reported correctly ### [v0.23.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.23.0) - **Authorization-code login** — `auth login --auth-code ` now works through the `/connect` authorization-code exchange, enabling browserless login flows for AI agents and hosted environments ### [v0.22.4](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.22.4) - **`constituent` now supports ETFs** — ETF symbols return an asset-allocation breakdown (holdings / regional / asset-class / industry tables); index symbols behave exactly as before - **Full US ETF holdings from SEC N-PORT** — for US ETFs, `constituent` fetches the complete portfolio from SEC EDGAR N-PORT filings by default (weight, shares, market value — e.g. all 500+ holdings of `IVV.US`); falls back to the platform's asset-allocation summary when SEC data is unavailable ### [v0.22.3](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.22.3) - **`quote` now includes the US overnight session** — `quote --format json` now populates `overnight_quote` alongside `pre_market_quote` and `post_market_quote`; previously the overnight field was always `null`, skewing after-close analysis in AI workflows - **Account-type banner on holdings commands** — `positions`, `fund-positions`, `assets`, and `portfolio` now print a one-line banner (`Live A/C (real account)` / `Demo A/C (simulated account)`) before the table, so it's clear which account the data belongs to; `--format json` output is unchanged ### [v0.22.2](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.22.2) - **JSON timestamps now RFC 3339** — time-series and history commands (`kline`, `kline-history`, `trades`, `intraday`, `capital-flow`, `capital-dist`, `market-temp`, `topics`) and account P&L flows now output ISO 8601 / RFC 3339 datetimes instead of raw Unix epochs - **`market-temp --history` default range** — omitting `--start` now defaults to 30 days before the end date instead of today, so a single `--history` call returns a full month of data ### [v0.22.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.22.0) - **New `shareholder --top`** — Top-20 major shareholders (institutions, individuals, insiders) with multi-period comparison; `--object-id ` for single shareholder holding history and trade details - **Extended `short-positions`** — Added HK market support (`.HK` suffix auto-routes to HKEX short-position data) - **New `short-trades`** — Daily short sale volume (US: FINRA/NASDAQ; HK: HKEX disclosure data) - **New `compare`** — Multi-stock valuation comparison (PE/PB/PS/market-cap/close); server auto-selects peers when no comparison symbols given - **New `top-movers`** — Stocks whose price movement exceeds the 20-day standard deviation, with correlated news; supports `--market`, `--sort time|change|hot` - **New `screener` command group** — Stock screener: `strategies` (recommended/saved), `search --strategy-id ` or `--filter key:min:max`, `indicators` to list available filters - **New `rank`** — Popularity leaderboard; list all categories without `--key`, or pass `--key ` for a specific ranking (e.g. `ib_hot_all-us`) - MCP server updated with the same new tools ### [v0.21.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.21.0) - **New: `business-segments`** — revenue breakdown by business segment, current period or historical trend - **New: `industry-rank`** — industry ranking by market (US/HK/CN/SG) and indicator; counter_id output feeds directly into `industry-peers` - **New: `industry-peers`** — hierarchical sub-sector tree with stock count, daily change, and YTD change per node - **New: `financial-report snapshot`** — AI earnings summary with beat/miss analysis vs consensus estimates and upcoming peer earnings dates - **New: `institution-rating --views`** — month-by-month buy/hold/sell distribution timeline ### [v0.20.3](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.20.3) - **Breaking: `analyst-estimates` removed** — command has been removed; the same data is available via `consensus` (EPS and revenue estimates) - **Fix: HK symbol leading zeros** — inputs like `00700.HK` or `09988.HK` now correctly resolve to `700.HK` / `9988.HK`; `operating` updated to reflect HK-only data coverage - **Fix: `ipo detail`** — auto-detects market from symbol suffix (`SUJA.US` → US, `700.HK` → HK), so `--market` is no longer required; cleaner error message when no IPO data is found; Payment Deadline formatted as RFC 3339 ### [v0.20.2](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.20.2) - **Fix: `institution-rating --history`** — restructured as a proper table with logical column ordering; timestamps formatted as `YYYY-MM-DD`; price targets rounded to 2 decimal places; `evaluate_history` capped to 20 most recent records - **Fix: IPO date display** — `ipo listed`, `ipo wait-listing`, `ipo calendar`, `ipo us-wait-listing` now show correct dates (e.g. `2026-05-11`) instead of a bogus 1970 date ### [v0.20.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.20.0) - **`ipo` command group** — comprehensive IPO tools: `subscriptions`, `wait-listing`, `listed`, `calendar`, `detail`, `orders`, `profit-loss` for HK market; `us-subscriptions`, `us-wait-listing`, `us-listed` for US market; `orders detail ` for full order detail - **`financial-statement`** — detailed, hierarchical financial statements (income statement, balance sheet, cash flow) with full line-item breakdown and YoY comparison; supports `--kind IS/BS/CF/ALL` and `--report af/saf/qf/cumul` - **`financial-report --latest`** — new flag to fetch the latest report summary (key indicators: revenue, net profit, EPS, ROE, total assets) without fetching the full statement - **`valuation-rank`** — daily PE/PB/PS industry percentile rank over a date range, showing `rank/total` for each metric - **`institution-rating --history` / `--industry-rank`** — new flags: `--history` shows how analyst ratings and price targets have changed over time; `--industry-rank` ranks all stocks in the same industry by analyst coverage - **`news search` / `topic search`** — keyword search across news articles and community topics - **`bank-cards`** — list bank cards linked to your account - **`withdrawals`** / **`deposits`** — view withdrawal and deposit history with date formatting and optional state/currency filters - **`portfolio short-margin`** — short-selling margin deposit details per position - **Fix: paper-trading account channel** — `auth status` and quote mall QR links now correctly reflect the account channel for paper-trading accounts (`lb_papertrading`), resolved from the access token JWT rather than hardcoded ### [v0.19.2](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.19.2) - **`finance-calendar` revamp** — restructured into subcommands (`report`, `dividend`, `split`, `ipo`, `macrodata`, `closed`); new `--filter watchlist|positions` scopes events to your watchlist or holdings - **`quote`** — new "Last Chg%" column showing price change vs previous close - **`corp-action`** — defaults to 30 items; add `--all` to retrieve all records - **`update --force`** — skip version check and force reinstall; auto-retries with `sudo` on permission error - **TUI** — full mouse support; chart type toggle (line / candlestick) in stock detail view ### [v0.19.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.19.0) - **TUI: History orders tab** — press `Tab` on the Orders page to switch between Today and History; History mode fetches the last 30 days by default; press `f` to open a date-range filter popup - **TUI: Cancel and modify orders** — press `c` to cancel or `m` to modify an active today order directly from the orders table; a confirmation step is shown before submitting - **`auth status` quote packages** — displays a formatted table of subscribed quote packages (market, name, validity period) and prints a QR code to open the quote mall in the Longbridge App - **`calc-index` field aliases** — short aliases for common fields: `iv` (implied_volatility), `oi` (open_interest), `vol` (volume), `mktcap` (total_market_value), `exp` (expiry_date), `strike` (strike_price); `--help` now groups fields into General and Options/Warrants sections - **`quant run` command** — run a quant indicator script server-side against historical K-line data; supply the script inline with `--script` or pipe via stdin; outputs computed plot values as JSON - **`update` release notes** — only the 10 most recent entries are shown after `longbridge update` completes; `sudo` is suggested when the binary lives in `/usr/local/bin` ### [v0.18.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.18.0) - **TUI: Orders page** — interactive orders table with trading shortcuts and an order entry dialog for placing trades without leaving the terminal - **`dividend --page` / `--year`** — paginate through large dividend histories and filter by year; fetches 50 records per page (up from 30) ### [v0.17.4](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.17.4) - **`--limit` alias for `--count`** — all commands that accept `--count` now also accept `--limit` as an alias, improving compatibility for AI agent tool-calling - **Fix: Unix self-update ETXTBUSY** — `longbridge update` no longer fails with "Text file busy" on Unix; the update now uses a staged temp file and atomic rename instead of writing directly to the running binary ### [v0.17.3](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.17.3) - **Fix: token refresh hang** — when the access token expired on a flaky network, the CLI no longer waits 5 minutes before failing; it now fails immediately with a clear error and preserves the token file for the next retry - **`auth status` accuracy** — now shows three states: `valid` (green), `refresh pending` (yellow, access token expired but refresh token valid — next command auto-refreshes with no user action needed), `expired` (red, re-login required); previously `refresh pending` was incorrectly shown as `expired` - **Fix: `--auth-code` login** — browser OAuth flow now triggers correctly when no token file exists - **Fix: Windows browser launch** — OAuth URLs containing `&` parameters no longer get truncated on Windows; switched to the `open` crate for cross-platform browser launching ### [v0.17.1](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.17.1) - **`completion` command** — generate shell tab-completion scripts for bash, zsh, fish, elvish, and powershell; redirect stdout to the appropriate file then reload your shell to activate (e.g. `longbridge completion zsh > ~/.zfunc/_longbridge`) - Sets `User-Agent: longbridge-cli/` on all HTTP and WebSocket requests - Adds `x-cli-cmd` request header identifying the active subcommand on every API call ### [v0.17.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.17.0) - **`dca` command** — recurring investment plans: create, update, pause, resume, stop, view trade history, stats summary, check symbol eligibility, and calculate next trade date; HK/SG accounts must agree to Terms and Conditions before creating a plan (`--agree-terms` to skip the interactive prompt) - **`sharelist` command** — community stock lists: list own and subscribed sharelists, browse trending lists (`popular`), create/delete sharelists, and add/remove/reorder constituent stocks - **`short-positions`** — US stock short selling data: short ratio, short shares, average daily volume, days-to-cover, and close price; updated bi-monthly by FINRA; `--count` 1–100 - **`option volume`** — real-time call/put volume snapshot with put/call ratio; `daily` subcommand for historical call/put volume and open interest - **`option chain`** — without `--date` now returns expiry dates only; pass `--date` to see strikes for a specific expiry - **`profit-analysis`** — added `--start`/`--end` date filtering for the summary command; Simple Yield and TWR now shown as percentages; breakdown renamed from "Stock P&L Breakdown" to "P&L Breakdown" (includes funds and MMF) ### v0.16.3 - **`auth` subcommand group** — `longbridge auth login`, `auth logout`, `auth status`; `auth status` shows token validity, expiry, account info, and quote level locally without network - **`alert enable` / `alert disable`** — toggle price alerts on/off without deleting them - **Fix: US index symbols** — `.DJI.US`, `.VIX.US` and other US index symbols now parse correctly; US indexes require a leading dot (e.g. `.DJI.US`, not `DJI.US`) - **"Did you mean?" hints** — when a query returns no data, the CLI suggests the correct symbol format: missing market suffix → `TSLA.US` / `700.HK`; missing leading dot → `.DJI.US` ### v0.16.1 **Enhancements** - `option quote` — now returns all fields from the OptionQuote API (added `timestamp`, `trade_status`, `open_interest`, `historical_volatility`, `contract_multiplier`, `contract_size`, `direction`, `underlying_symbol`); JSON output uses proper typed values instead of table-column strings - `calc-index` — Theta, Vega, and Rho values are now normalized (÷100) to standard per-share conventions; auto-detects option symbols and switches to Greeks default fields when stock defaults return empty - `capital` — improved argument handling - `market-status` — fixed incorrect `trade_status` mapping (105 = afternoon trading session); JSON output now returns human-readable market and status labels instead of raw API codes - Parameter standardization: `--adjust none/forward` (was `no_adjust/forward_adjust`), `--tif day/gtc/gtd` (was `Day/GoodTilCanceled/GoodTilDate`), `--format table` as default name (alias: `pretty`), `finance-calendar --start/--end` (was `--date/--end-date`), `statement --start-date` now accepts `YYYY-MM-DD` format - TUI: fixed watchlist sort jumping and made scrollbar more subtle ### [v0.16.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.16.0) 21 new commands covering company fundamentals, market data, and account features. **New: Company & Fundamentals** - `company` — company overview (founding date, employees, IPO price, address) - `executive` — company executives and key personnel - `industry-valuation` — industry valuation comparison with peers (PE/PB/EPS/DY); `dist` subcommand for percentile ranking - `operating` — operating reviews: financial indicators table + management review - `corp-action` — corporate actions (splits, dividends, rights, etc.) - `invest-relation` — investment relations (subsidiary/parent companies) **New: Market & Quotes** - `constituent` — index/ETF constituent stocks with sorting + rise/fall stats - `market-status` — market open/close status for each exchange - `broker-holding` — broker holding positions for HK stocks (top/detail/daily) - `ah-premium` — A/H premium ratio kline and intraday data for dual-listed stocks - `trade-stats` — trade statistics (price distribution by volume) - `anomaly` — quote anomalies / unusual market movements **New: Account** - `alert` — price alerts (list/add/delete) - `profit-analysis` — P&L summary + per-stock breakdown; `detail` for individual stock P&L with transaction flows; `by-market` for market-filtered view **Enhancements** - `update` — cross-platform self-update with Windows support and CDN acceleration; `--release-notes` to view changelog; auto-shows release notes on version change - `intraday --date` — retrieve historical intraday data for a past date - TUI: press `/` to search watchlist or type a symbol to jump directly to any stock - `BROWSER` env var support for custom browser selection during login ### [v0.15.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.15.0) - **New: `portfolio` command** — total P/L, asset distribution by market (US/HK/CN/SG/Cash), holdings, and cash balances - **New: `investors` command** — SEC 13F-based active fund manager rankings; view any investor's holdings by CIK with live prices - **New: `insider-trades`** — SEC Form 4 insider transaction history for any symbol - **New: `watchlist pin/unpin`** — pin securities to the top of a watchlist group - **Enhanced: `assets`** — renamed from `balance`; now shows full asset overview: net assets, buying power, margin, risk level, and per-currency cash breakdown ### [v0.14.2](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.14.2) - **New: `--lang` global flag** — set content language (`zh-CN`, `zh-HK`, `en`) for all commands; falls back to system `LANG` env var then `en` ### [v0.14.1](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.14.1) - **New: CN region login** — `longbridge auth login` now supports China region routing - **New: `-v` flag** — show version without entering the full command ### [v0.14.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.14.0) - **New: Device auth login** — `longbridge auth login` now uses OAuth device flow; displays a URL and code to authorize on any device, works in SSH and headless environments; `--headless` flag removed - **New: Order enhancements** — trailing stop and AO order types; `--expire-date`, `--outside-rth`, `--remark` added to order commands - **Fix: Linux segfault** — prebuilt Linux binary now uses musl to fix crash on some distributions ### [v0.13.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.13.0) - **New: Fundamentals & analysis commands** — `financial-report`, `valuation`, `forecast-eps`, `consensus`, `institution-rating`, `shareholder`, `fund-holder`, `dividend`, `finance-calendar`, `exchange-rate` - **Breaking: command restructure** — 19 flat commands moved into subcommand trees (e.g. `news-detail` → `news detail`, `kline-history` → `kline history`, `warrant-list` → `warrant list`) - **CN region support** — set `LONGBRIDGE_REGION=cn` to route through the China endpoint ### [v0.12.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.12.0) - **New: `statement` commands** — list and export daily/monthly account statements - **TUI** — fixed `q` quit; added news list and detail views inside watchlist --- Full changelog: [github.com/longbridge/longbridge-terminal/releases](https://github.com/longbridge/longbridge-terminal/releases)