Jason Lee
1a637e7d0b
Checked the reference against the `QuerySignals` / `Signal` RPC definitions and against production responses: - `status` documents its lifecycle values (0 pending … 5 analysis submit failed) instead of being left unexplained. - `total` is `int32`, matching `QuerySignalsResponse`. - `risk_level` and `display_control` are dropped from the field tables and examples — neither is in the `Signal` message, and production returns neither. - `catalyst_name` says what it matches: the triggering factor's name (`EARNINGS_RELEASED`, `macd_12_26_9`), not the prose `key_catalyst` a signal displays. Filtering by the value shown in `key_catalyst` returns nothing, so both fields now spell out which is which. - `start_time` / `end_time` also accept a Unix timestamp (≥ 10¹² read as milliseconds), per the field definitions. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Longbridge Developers
Longbridge Developers is the official developer platform for Longbridge — providing programmatic access to real-time market data, trading, account management, and AI integrations across HK, US, and CN markets.
Repository structure
/
├── docs/ # Site content and VitePress config
│ ├── .vitepress/ # Theme, components, markdown plugins, locale configs
│ ├── en/ # English content (root locale)
│ ├── zh-CN/ # Simplified Chinese content
│ └── zh-HK/ # Traditional Chinese content
├── openapi/ # Submodule: OpenAPI spec + SDK source (openapi, Python, Rust, etc.)
├── openapi-go/ # Submodule: Go SDK
├── longbridge-terminal/ # Submodule: CLI binary source (longbridge)
├── skills/longbridge/ # AI Skill — knowledge base for AI agents
├── scripts/ # Build scripts (llms.txt generation, markdown normalization)
├── openapi.yaml # Canonical API specification (source of truth for API Reference)
└── CONTRIBUTING.md # Contribution guidelines for AI agents and humans
What you can build
- Automated trading strategies and order management
- Real-time quote dashboards and data pipelines
- Portfolio trackers and risk monitoring tools
- AI agents with live market data and trading capabilities
Access methods
| Method | Best for |
|---|---|
| SDK | Python, Rust, Node.js, Go, Java, C++ apps |
| HTTP / WebSocket API | Any language, custom integrations |
CLI (longbridge) |
Terminal workflows, scripting, AI tool-calling |
| MCP | ChatGPT Apps and AI assistants (Cursor, Claude, etc.) |
| Skill | Give any AI direct knowledge of Longbridge APIs |
Quick start
1. Open a Longbridge account
Download the Longbridge App and complete account onboarding.
2. Enable OpenAPI access
Log in to open.longbridge.com, complete developer verification, and obtain your API token.
3. Choose your integration
CLI — fastest way to get started:
brew install --cask longbridge/tap/longbridge-terminal
longbridge auth login
longbridge quote TSLA.US NVDA.US 700.HK
Python SDK:
pip install longbridge
MCP for AI assistants — in ChatGPT web, desktop, or mobile, open the Longbridge ChatGPT App or search longbridge in Apps, authorize, then use @longbridge in the message box.
For other MCP clients, add Longbridge as a remote MCP server:
{
"mcpServers": {
"longbridge": {
"url": "https://mcp.longbridge.com"
}
}
}
AI Skill — give your AI full knowledge of Longbridge APIs:
npx skills add longbridge/developers -g -y
Market coverage
| Market | Instruments |
|---|---|
| Hong Kong | Equities, ETFs, Warrants, CBBCs, Hang Seng Index |
| United States | Stocks, ETFs, OPRA Options, Nasdaq Index |
| China A-share | Stocks, ETFs, Index |
Documentation
- Getting Started — https://open.longbridge.com/docs/getting-started
- API Reference — https://open.longbridge.com/docs/api
- SDK Reference — https://open.longbridge.com/sdk
- CLI Reference — https://open.longbridge.com/docs/cli
- MCP Setup — https://open.longbridge.com/docs/mcp
- LLM / AI Integration — https://open.longbridge.com/docs/llm
- Changelog — https://open.longbridge.com/docs/changelog
LLM-friendly docs
All documentation pages are available as Markdown by appending .md to any URL:
https://open.longbridge.com/docs/getting-started.md
https://open.longbridge.com/docs/quote/pull/static.md
A machine-readable index is available at:
https://open.longbridge.com/llms.txt
Pricing
OpenAPI access is free for Longbridge Integrated Account holders. No additional fees for activating or using the API. Standard brokerage transaction fees apply to trades.
Contributing
Local development setup
git clone --recurse-submodules https://github.com/longbridge/developers.git
cd developers
bun install
bun run dev
If you already cloned without --recurse-submodules:
git submodule update --init --recursive
bun run dev
The dev server starts at http://localhost:5173 and connects to the canary API. Use bun run dev:prod to connect to the production API instead.
See CONTRIBUTING.md for full contribution guidelines.