longbridge

SKILL.md

Longbridge Developers Platform

Full-stack financial data and trading platform: CLI, Python/Rust SDK, MCP, and LLM integration.

Official docs: https://open.longbridge.com
llms.txt: https://open.longbridge.com/llms.txt

For setup and authentication details, see references/setup.md.

Data Query Priority

Always use the CLI for data queries. Use MCP only if the CLI cannot fulfill the request.
CLI covers (use these first):

Market data: quotes, K-line history, intraday, extended hours

News, filings, topics, market sentiment

Account: positions, portfolio, assets, orders, statements

Institutional: investors (SEC 13F), insider trades

Fall back to MCP only when:

longbridge --help confirms no command exists for the required data

The user's environment has no CLI installed or accessible

Investment Analysis Workflow

When the user asks about stock performance, portfolio advice, or market analysis:

Get live data via CLI — quotes, positions, K-line history, intraday. CLI first; MCP only if CLI can't cover it.

Get news/catalysts via CLI — prefer Longbridge first; fall back to WebSearch only if insufficient

Combine — price action + volume + catalyst → analysis + suggestion

# Market data
longbridge quote SYMBOL.US
longbridge positions                # stock positions
longbridge portfolio                # P/L, asset distribution, holdings, cash (always pull when user asks about "my portfolio")
longbridge kline history SYMBOL.US --start YYYY-MM-DD --end YYYY-MM-DD --period day
longbridge intraday SYMBOL.US

# News & content (prefer these over WebSearch)
longbridge news SYMBOL.US           # latest news articles
longbridge news detail <id>         # full article content
longbridge filing SYMBOL.US         # regulatory filings list (8-K, 10-Q, 10-K, etc.)
longbridge topic SYMBOL.US          # community discussion
longbridge market-temp              # market sentiment index (0–100)

# Account
longbridge assets                   # full asset overview: cash, buying power, margin, risk level
longbridge statement --help         # check subcommands for statement export options

# Institutional investors (SEC 13F)
longbridge investors                # top active fund managers by AUM
longbridge investors <CIK>          # holdings for a specific investor by CIK
longbridge insider-trades SYMBOL.US # SEC Form 4 insider transaction history

For commands with complex flags, always run longbridge <command> --help for current options.

Only fall back to WebSearch when Longbridge news is insufficient (e.g., breaking news not yet indexed, macro events unrelated to a specific symbol).

Choose the Right Tool

AI agents fetching data: CLI first, MCP only as fallback when CLI lacks the capability.

User wants to...                         → Use
─────────────────────────────────────────────────────────────────
Quick quote / one-off data lookup        CLI  ← AI default
Interactive terminal workflows           CLI
Script market data, save to file         CLI + jq  (or Python SDK)
Loops, conditions, transformations       Python SDK (sync)
Async pipelines, concurrent fetches      Python SDK (async)
Production service, high throughput      Rust SDK
Real-time WebSocket subscription loop    SDK (Python or Rust)
Programmatic order strategy              SDK
Data not available via CLI               MCP (fallback)
Talk to AI about stocks (no code)        MCP (hosted or self-hosted)
Use Cursor/Claude for trading analysis   MCP
Add Longbridge API docs to IDE/RAG       LLMs.txt / Markdown API

Symbol Format

<CODE>.<MARKET> — applies to all tools.

Market
Suffix
Examples

Hong Kong
HK
700.HK, 9988.HK, 2318.HK

United States
US
TSLA.US, AAPL.US, NVDA.US

China Shanghai
SH
600519.SH, 000001.SH

China Shenzhen
SZ
000568.SZ, 300750.SZ

Singapore
SG
D05.SG, U11.SG

Crypto
HAS
BTCUSD.HAS, ETHUSD.HAS

Reference Files

CLI (Terminal)

Overview — install, auth, output formats, patterns: references/cli/overview.md

Always use longbridge --help to list available commands, and longbridge <command> --help for specific options and flags. Do not rely on hardcoded documentation — the CLI's built-in help is always up-to-date.

Python SDK

Overview — install, Config, auth, HttpClient: references/python-sdk/overview.md

QuoteContext — all quote methods + subscriptions: references/python-sdk/quote-context.md

TradeContext — orders, account, executions: references/python-sdk/trade-context.md

Types & Enums — Period, OrderType, SubType, push types: references/python-sdk/types.md

Rust SDK

Overview — Cargo.toml, Config, auth, error handling: references/rust-sdk/overview.md

QuoteContext — all methods, SubFlags, PushEvent: references/rust-sdk/quote-context.md

TradeContext — orders, SubmitOrderOptions builder, account: references/rust-sdk/trade-context.md

Content — news, filings, topics (ContentContext + Python fallback): references/rust-sdk/content.md

Types & Enums — all Rust enums and structs: references/rust-sdk/types.md

AI Integration

MCP — hosted service, self-hosted server, setup & auth: references/mcp.md

LLMs & Markdown — llms.txt, open.longbridge.com doc Markdown, longbridge.com live news/quote pages (.md suffix + Accept header), Cursor/IDE integration: references/llm.md

Load specific reference files on demand — do not load all at once.