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.

---

Investment Analysis Workflow

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

1. Get live data via CLI — quotes, positions, K-line history, intraday
2. Get news/catalysts via CLI — prefer Longbridge first; fall back to WebSearch only if insufficient
3. Combine — price action + volume + catalyst → analysis + suggestion

# Market data
longbridge quote SYMBOL.US
longbridge positions                # 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-detail <id>       # regulatory filing (earnings reports, etc.)
longbridge topics SYMBOL.US         # community discussion
longbridge market-temp              # market sentiment index (0–100)

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

User wants to...                         → Use
─────────────────────────────────────────────────────────────────
Quick quote / one-off data lookup        CLI
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
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.