Longbridge Terminal is an AI-native command-line tool designed for the Longbridge Securities platform, offering real-time market data, portfolio management, and trading capabilities across HK, US, A-share, and Singapore markets. It provides structured JSON output for AI-agent tool-calling and includes a full-screen TUI for interactive monitoring.
Key Features:
Real-time quotes, depth, K-lines, options, and warrants
Account balances, stock, and fund positions monitoring
Order submission, modification, cancellation, and execution history tracking
Structured JSON output for seamless AI-integration
Full-screen TUI for real-time market data visualization
Audience & Benefit:
Ideal for traders, investors, developers integrating AI with trading platforms, and those needing a command-line interface for scripting. It streamlines daily trading workflows, enabling efficient decision-making and automation of repetitive tasks.
AI-native CLI for the Longbridge trading platform — real-time market data, portfolio, and trading. Also ships a full-screen TUI for interactive monitoring.
Covers every Longbridge OpenAPI endpoint: real-time quotes, depth, K-lines, options, and warrants for market data; account balances, stock and fund positions for portfolio management; and order submission, modification, cancellation, and execution history for trading. Designed for scripting, AI-agent tool-calling, and daily trading workflows from the terminal.
Uses OAuth 2.0 via the Longbridge SDK — no manual token management required.
longbridge auth login # Opens browser for OAuth and saves token (managed by SDK)
longbridge auth logout # Clear saved token
longbridge check # Verify token, region, and API endpoint connectivity
Token is shared between CLI and TUI. After login, all commands work without re-authenticating.
The CLI picks its API access point from your location: it asks geotest.lbkrs.com which country you are in and caches the answer for 6 hours, so at most one command per session waits on the probe. China Mainland uses the .cn endpoints; everywhere else uses the global ones.
longbridge check # Re-detect the access point, and show both latencies
LONGBRIDGE_REGION=global ... # Pin the access point explicitly (cn or global)
check never trusts the cache. It re-detects, measures both endpoints, and repins to whichever one is decisively better — location only approximates that, and a split-tunnel proxy can route the geo probe and the API over entirely different paths. The result is persisted, so later commands follow it too.
Shell Completion
Enable tab-completion for longbridge commands and flags in your shell:
Bash — add to ~/.bashrc or ~/.bash_profile:
source <(longbridge completion bash)
Zsh — add to ~/.zshrc:
source <(longbridge completion zsh)
Fish — add to ~/.config/fish/config.fish:
longbridge completion fish | source
After reloading your shell, longbridge will suggest subcommands, flags, and values.
CLI Usage
longbridge [options]
All commands support --format json for machine-readable output. Commands that accept --count also accept --limit as an alias (for AI agent compatibility):
longbridge check # Check token validity, and API connectivity
Quotes
longbridge quote TSLA.US 700.HK # Real-time quotes for one or more symbols
longbridge depth TSLA.US # Level 2 order book depth (bid/ask ladder)
longbridge brokers 700.HK # Broker queue at each price level (HK market)
longbridge trades TSLA.US [--count 50] # Recent tick-by-tick trades
longbridge intraday TSLA.US # Intraday minute-by-minute price and volume lines for today
longbridge kline TSLA.US [--period day] # OHLCV candlestick (K-line) data [--adjust none|forward]
longbridge kline history TSLA.US --start 2024-01-01 # Historical OHLCV candlestick data within a date range
longbridge static TSLA.US # Static reference info for one or more symbols
longbridge calc-index TSLA.US --fields pe,pb,eps # Calculated financial indexes (PE, PB, EPS, turnover rate, etc.)
longbridge capital TSLA.US # Capital distribution snapshot (large/medium/small inflow and outflow)
longbridge capital TSLA.US --flow # Intraday capital flow time series (large/medium/small money in vs out)
longbridge market-temp [HK|US|CN|SG] # Market sentiment temperature index (0–100, higher = more bullish)
longbridge constituent .SPX.US [--sort market-cap] # Index constituent stocks (US indexes need a leading dot, e.g. .DJI.US, .SPX.US)
longbridge constituent IVV.US [--limit 0] # For a US ETF, full holdings from SEC N-PORT (--limit 0 = all); falls back to platform asset allocation when SEC data is unavailable (e.g. SPY)
longbridge trading session # Trading session schedule (open/close times) for all markets
longbridge trading days HK # Trading days and half-trading days for a market
longbridge security-list HK # Full list of securities available in a market
longbridge participants # Market maker (participant) broker IDs and names
longbridge subscriptions # Active real-time WebSocket subscriptions for this session
News
longbridge news TSLA.US [--count 20] # Latest news articles for a symbol
longbridge news detail # Full Markdown content of a news article
longbridge filing list AAPL.US [--count 20] # Regulatory filings and announcements for a symbol
longbridge filing detail AAPL.US # Full Markdown content of a filing; --file-index N for multi-file filings (e.g. 8-K exhibit)
longbridge topic list TSLA.US [--count 20] # Community discussion topics for a symbol
longbridge topic detail # Full details of a community topic (body, author, tickers, counts, URL)
longbridge topic replies [--page 1] # Paginated list of replies for a topic (--size 1–50)
longbridge topic mine [--type article] # Topics created by the authenticated user
longbridge topic create --body "…" # Publish a new community discussion topic (--title optional)
longbridge topic create-reply --body "…" # Post a reply to a topic (--reply-to for nested replies)
Options & Warrants
longbridge option quote AAPL240119C190000 # Real-time quotes for option contracts
longbridge option chain AAPL.US # Option chain: list all expiry dates
longbridge option chain AAPL.US --date 2024-01-19 # Option chain: strike prices for a given expiry
longbridge option volume AAPL.US # Real-time option Call/Put volume and Put/Call ratio
longbridge option volume daily AAPL.US # Daily option Call/Put volume and open interest history
longbridge option volume daily AAPL.US --count 60 # Return last 60 trading days
longbridge warrant quote 12345.HK # Real-time quotes for warrant contracts
longbridge warrant 700.HK # Warrants linked to an underlying security
longbridge warrant issuers # Warrant issuer list (HK market)
Fundamentals
longbridge financial-report AAPL.US [--kind IS|BS|CF] # Multi-period financial statements (income / balance sheet / cash flow)
longbridge financial-report AAPL.US --latest # Latest financial report summary
longbridge financial-report snapshot AAPL.US --report qf --year N --period N # Earnings summary + forecast vs actual (revenue/EBIT/EPS beat/miss) + financial ratios
longbridge financial-statement AAPL.US [--kind IS|BS|CF|ALL] [--report af|saf|qf|cumul] # Detailed financial statement (v3 endpoint)
longbridge institution-rating AAPL.US # Analyst rating distribution and consensus target price
longbridge institution-rating AAPL.US --history # Rating and target price change history
longbridge institution-rating AAPL.US --industry-rank [--page 1] [--limit 20] # Industry-wide institution rating ranking
longbridge institution-rating AAPL.US --views # Monthly buy/hold/sell distribution timeline (institutional views)
longbridge institution-rating detail AAPL.US # Monthly rating trend and analyst accuracy history
longbridge dividend AAPL.US # Historical dividend records
longbridge dividend detail AAPL.US # Dividend allocation plan details
longbridge forecast-eps AAPL.US # Analyst EPS consensus forecast snapshots
longbridge consensus AAPL.US # Revenue / profit / EPS multi-period comparison with beat/miss markers
longbridge valuation AAPL.US [--indicator pe|pb|ps|dvd_yld] # Current valuation snapshot and peer comparison
longbridge valuation AAPL.US --history [--indicator pe] [--range 5] # Historical valuation time series (1 / 3 / 5 / 10 years)
longbridge valuation-rank AAPL.US [--start 20240101] [--end 20241231] # Industry valuation percentile ranking (default: last 30 days)
longbridge analyst-estimates AAPL.US # Analyst consensus EPS estimates
longbridge fund-holder AAPL.US [--count 20] # Funds and ETFs holding this stock
longbridge shareholder AAPL.US [--range all|inc|dec] [--sort chg] # Institutional shareholders with QoQ change tracking
longbridge shareholder AAPL.US --top # Top 20 major shareholders (includes individuals and insiders, multi-period)
longbridge shareholder AAPL.US --object-id # Holding and trade detail for a specific shareholder (use ID from --top output)
longbridge compare AAPL.US # Multi-stock valuation comparison vs server-selected industry peers
longbridge compare 9988.HK 700.HK 9999.HK [--currency HKD] # Compare specific stocks side by side (price, market cap, PE/PB/PS, ROE, ROA, div yield, and more)
longbridge corp-action 700.HK [--all] # Corporate actions (splits, dividends, rights, etc.) — default 30, --all for full history
longbridge business-segments AAPL.US [--history] [--report qf|saf|af] [--cate ] # Revenue segment breakdown (current snapshot or historical trends)
longbridge industry-rank --market US|HK|CN|SG [--indicator leading-gainer|...|net-profit-growth] # Industry ranking list; output symbols feed into industry-peers
longbridge industry-peers IN00446.US # Industry peer group hierarchy tree for an industry index symbol (from industry-rank)
longbridge macrodata [--country US] [--page 1] [--limit 20] # List macroeconomic indicators (20/page); names follow --lang
longbridge macrodata US00175 [--start 2024-01-01] [--end 2024-12-31] # Historical releases for one indicator (actual / forecast / previous)
Deposits & Withdrawals
longbridge bank-cards # List linked bank cards
longbridge withdrawals [--page 1] [--limit 20] # Withdrawal history
longbridge deposits [--page 1] [--limit 20] [--states 0,1,2] [--currencies HKD,USD] # Deposit history
Search
longbridge search TSLA [--tab market|news|posts|hashtags|help|share-lists|users|institutions] # Search across multiple content types
longbridge search-hot # Hot search keywords
IPO
longbridge ipo subscriptions # IPO stocks currently in filing or subscription stage
longbridge ipo wait-listing # IPO stocks in grey-market (wait-listing) stage
longbridge ipo listed [--page 1] [--limit 20] # Recently listed IPO stocks
longbridge ipo calendar # IPO calendar (all upcoming and recent IPOs)
longbridge ipo detail [--market HK|US] # IPO profile, timeline, eligibility, and holdings for a symbol
longbridge ipo orders [--market HK] [--status 0] [--page 1] # IPO orders (active + history) for the current account
longbridge ipo orders detail # Full detail for a single IPO order
longbridge ipo profit-loss [--period all|1m|3m|6m|1y] [--page 1] # IPO P&L summary and item list
longbridge ipo us-subscriptions # US IPO stocks currently in subscription stage
longbridge ipo us-wait-listing # US IPO stocks in wait-listing stage
longbridge ipo us-listed [--page 1] [--limit 20] # Recently listed US IPO stocks
longbridge ipo submit TSLA.US --qty 200 --amount 1000 [--method 2] # Submit IPO subscription (prompts for confirmation)
longbridge ipo withdraw # Withdraw IPO subscription (prompts for confirmation)
Market Data
longbridge rank # List available popularity ranking tab keys
longbridge rank --key ib_hot_all-us [--count 20] # Stocks ranked by composite heat score (trading activity, media, community, volatility)
longbridge top-movers [--market HK|US|CN|SG] [--sort hot|time|chg] # Stocks with abnormal price moves paired with correlated news and reason summaries
longbridge exchange-rate # Exchange rates for all markets
longbridge finance-calendar financial [--symbol AAPL.US] # Earnings guidance announcements from today onward
longbridge finance-calendar report [--symbol AAPL.US] # Earnings report release dates from today onward
longbridge finance-calendar dividend [--symbol AAPL.US] # Dividend ex-date / payment events from today onward
longbridge finance-calendar ipo [--market US] # IPO listing timeline from today onward
longbridge finance-calendar macrodata [--star 3] # Macro economic events (--star 1–3 filters by importance)
longbridge finance-calendar closed [--market HK] # Market holidays and shortened trading days
Watchlist
longbridge watchlist # List all watchlist groups and their securities (pinned shown first)
longbridge watchlist show # Show securities in a specific group (pinned marked)
longbridge watchlist create "My Portfolio" # Create a new watchlist group
longbridge watchlist update --add TSLA.US # Add securities in a group
longbridge watchlist update --remove AAPL.US # Remove securities from a group
longbridge watchlist delete # Delete a watchlist group
longbridge watchlist pin TSLA.US AAPL.US # Pin securities to the top of their group
longbridge watchlist pin --remove 700.HK # Unpin securities
Sharelist
longbridge sharelist # List own and subscribed sharelists
longbridge sharelist [--count 50] # List with custom page size
longbridge sharelist detail # Show full details and constituent stocks
longbridge sharelist create --name "My Picks" [--description "…"] # Create a new sharelist
longbridge sharelist delete # Delete a sharelist
longbridge sharelist add TSLA.US AAPL.US 700.HK # Add stocks to a sharelist
longbridge sharelist remove TSLA.US # Remove stocks from a sharelist
longbridge sharelist sort TSLA.US AAPL.US 700.HK # Reorder stocks in a sharelist
longbridge sharelist popular [--count 10] # Get popular (trending) sharelists
Trading
longbridge order # Today's orders, or historical with --history
longbridge order --history [--start 2024-01-01] # Historical orders (use --symbol to filter)
longbridge order detail # Full detail for a single order including charges and history
longbridge order executions # Today's trade executions (fills), or historical with --history
longbridge order buy TSLA.US 100 --price 250.00 # Submit a buy order (prompts for confirmation)
longbridge order sell TSLA.US 100 --price 260.00 # Submit a sell order (prompts for confirmation)
longbridge order cancel # Cancel a pending order (prompts for confirmation)
longbridge order replace --qty 200 --price 255.00 # Modify quantity or price of a pending order
longbridge assets [--currency USD] # Asset overview: net assets, cash, buy power, margins, and per-currency breakdown
longbridge cash-flow [--start 2024-01-01] # Cash flow records (deposits, withdrawals, dividends, settlements)
longbridge portfolio # Portfolio overview: total assets, P/L, holdings, and cash breakdown
longbridge portfolio short-margin # Short-selling margin deposit details
longbridge positions # Current stock (equity) positions across all sub-accounts
longbridge fund-positions # Current fund (mutual fund) positions across all sub-accounts
longbridge margin-ratio TSLA.US # Margin ratio requirements for a symbol
longbridge max-qty TSLA.US --side buy --price 250 # Estimate maximum buy or sell quantity given current account balance
Profit Analysis
longbridge profit-analysis # P&L summary with stock breakdown
longbridge profit-analysis detail 700.HK # Stock P&L breakdown + transaction flows
longbridge profit-analysis detail 700.HK --derivative # Show derivative flows
longbridge profit-analysis by-market # Stock P&L by market (paginated)
longbridge profit-analysis by-market --market HK --size 50 # Filter by market
Statements
longbridge statement list [--type daily|monthly] # List available account statements (daily or monthly)
longbridge statement export --file-key --section equity_holdings # Export statement sections as CSV or Markdown
longbridge statement export --file-key --all # Export all non-empty sections
Insider Trades
longbridge insider-trades TSLA.US # Recent Form 4 insider trades (SEC EDGAR, US stocks only)
longbridge insider-trades AAPL.US --count 40 # Fetch 40 Form 4 filings instead of the default 20
longbridge insider-trades NVDA.US --format json # Export as JSON
Investors
longbridge investors # Top 50 active fund managers by AUM (live SEC 13F rankings; passive index giants excluded; use --top N to change)
longbridge investors 0001067983 # View 13F holdings for any filer by SEC CIK number
longbridge investors 0001067983 --top 20 # Show top 20 positions only
longbridge investors 0001067983 --format json # Export holdings as JSON
longbridge investors changes 0001067983 # Quarter-over-quarter changes (NEW/ADDED/REDUCED/EXITED)
longbridge investors changes 0001067983 --from 2024-12-31 # Compare latest vs a specific period
Recurring Investment
longbridge dca # List all recurring investment plans
longbridge dca --status Active # Filter by status: Active | Suspended | Finished
longbridge dca --symbol TSLA.US # Filter by symbol
longbridge dca create TSLA.US --amount 500 --frequency weekly --day-of-week mon # Create weekly recurring investment plan
longbridge dca create 700.HK --amount 1000 --frequency monthly --day-of-month 15 # Monthly recurring investment plan
longbridge dca update --amount 800 # Update plan amount
longbridge dca pause # Pause a recurring investment plan
longbridge dca resume # Resume a paused recurring investment plan
longbridge dca stop # Permanently stop a recurring investment plan
longbridge dca history # Trade history for a plan
longbridge dca stats # Recurring investment statistics summary
longbridge dca calc-date TSLA.US --frequency weekly --day-of-week fri # Calculate next trade date
longbridge dca check TSLA.US AAPL.US 700.HK # Check which symbols support recurring investment
longbridge dca set-reminder 6 # Set reminder hours before trade (1 | 6 | 12)
Short Selling
longbridge short-positions AAPL.US # US: bi-weekly FINRA short interest (short interest, rate, days to cover)
longbridge short-positions 700.HK # HK: daily HKEX disclosed short positions (open short shares, balance, cost, rate)
longbridge short-positions TSLA.US --count 50 # Return last 50 records
longbridge short-trades AAPL.US # Daily short sale volume (FINRA/NASDAQ for US; HKEX for HK)
longbridge short-trades 700.HK [--count 50] # HK: amount, balance, total amount, rate, close per trading day
Stock Screener
longbridge screener strategies # List recommended stock-selection strategies
longbridge screener strategies --all # List all platform strategies
longbridge screener strategies --mine # List user-created strategies
longbridge screener strategies --id # Show groups and indicators for a specific strategy
longbridge screener search --strategy-id # Run a saved strategy and return matching stocks
longbridge screener search --market HK --filter filter_marketcap:100:1000 --filter filter_divyld:3: # Custom filter (key:min:max, omit bound to leave open)
longbridge screener indicators # List all available filter indicators with IDs, keys, and default value ranges
Symbol Format
. e.g. TSLA.US 700.HK 600519.SH
Markets: HK (Hong Kong) · US (United States) · CN / SH / SZ (China A-share) · SG (Singapore)
Skill
Install the skill to give your AI tools full knowledge of all longbridge CLI commands:
