Release Notes ​

v0.28.0 ​

  • Chat with LongbridgeAI in the terminal — 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 — 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 ​

  • Use LongbridgeAI over ACP — The new longbridge acp command runs LongbridgeAI as an Agent Client Protocol (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 <CHAT_UID> <MSG_ID> "…" for multi-turn follow-ups; agent continue chatbot <CHAT_UID> <MSG_ID> resumes an interrupted run (--answer / --answers-json); and agent --skill prints the agent skill doc for AI harnesses

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 ​

  • 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 ​

  • 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 ​

  • 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 ​

  • Authorization-code login — auth login --auth-code <CODE> now works through the /connect authorization-code exchange, enabling browserless login flows for AI agents and hosted environments

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 ​

  • quote now includes the US overnight session — quote <SYMBOL> --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 ​

  • 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 ​

  • New shareholder --top — Top-20 major shareholders (institutions, individuals, insiders) with multi-period comparison; --object-id <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 <id> or --filter key:min:max, indicators to list available filters
  • New rank — Popularity leaderboard; list all categories without --key, or pass --key <key> for a specific ranking (e.g. ib_hot_all-us)
  • MCP server updated with the same new tools

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 ​

  • 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 ​

  • 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 ​

  • 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 <id> 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 ​

  • 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 ​

  • 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 ​

  • 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 ​

  • --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 ​

  • 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 ​

  • 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/<version> on all HTTP and WebSocket requests
  • Adds x-cli-cmd request header identifying the active subcommand on every API call

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 ​

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 ​

  • 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 ​

  • 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 ​

  • 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 ​

  • 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 ​

  • 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 ​

  • 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