Release Notes ​

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