longbridge/openapi

Longbridge OpenAPI provides programmatic quote trading interfaces for investors with research and development capabilities and assists them to build trading or quote strategy analysis tools based on their own investment strategies. The functions fall into the following categories:
Trading - Create, amend, cancel orders, query today’s/past orders and transaction details, etc.
Quotes - Real-time quotes, acquisition of historical quotes, etc.
Portfolio - Real-time query of the account assets, positions, funds
Real-time subscription - Provides real-time quotes and push notifications for order status changes
This repo contains the following main components:
| Name | Document | Description |
| Rust | Doc | Longbridge OpenAPI for Rust (>= 1.89.0) |
| Python | Doc | Longbridge OpenAPI for Python 3 (>= 3.8) |
| Node.js | Doc | Longbridge OpenAPI for Node.js (>= 10) |
| Java | Doc | Longbridge OpenAPI for Java (>= 11) |
| C | Doc | Longbridge OpenAPI for C (>= C99) |
| C++ | Doc | Longbridge OpenAPI for C++(>= C++17) |
| Go | | https://github.com/longbridge/openapi-go |
| MCP | | An MCP server implementation for Longbridge OpenAPI |
## Context Types
| Context | Description |
| QuoteContext | Real-time quotes, candlesticks, options, warrants, watchlists, push subscriptions |
| TradeContext | Orders, positions, account balance, executions, cash flow |
| AssetContext | Account statement download |
| ContentContext | News, community topics |
| FundamentalContext | Financial reports, analyst ratings, dividends, valuation, company overview, shareholders |
| MarketContext | Market status, broker holdings, A/H premium, trade statistics, anomaly alerts, index constituents |
| CalendarContext | Financial calendar (earnings, dividends, splits, IPOs, macro data, market closures) |
| PortfolioContext | Exchange rates, portfolio P&L analysis |
| AlertContext | Price alert management (add/enable/disable/delete) |
| DCAContext | Dollar-cost averaging plan management |
| SharelistContext | Community sharelist management |
## Quickstart
Pick a language SDK from the table above and follow its README for install and first request. Full reference docs: https://longbridge.github.io/openapi
## SDK Documentation
https://longbridge.github.io/openapi
## Troubleshooting
Environment variables not taking effect
macOS/Linux: export ... only affects the current shell session.
Windows: setx ... requires opening a new terminal/session to take effect.
Authentication errors (401/403)
Verify LONGBRIDGEAPPKEY, LONGBRIDGEAPPSECRET, LONGBRIDGEACCESSTOKEN are correct and not expired.
Ensure your OpenAPI app has the required permissions.
Network / connection errors
Check firewall/proxy rules for HTTPS/WSS.
If you use a custom endpoint, set LONGBRIDGEHTTPURL, LONGBRIDGEQUOTEWSURL, LONGBRIDGETRADEWSURL.
Quote subscription exits immediately
Keep the process running (event loop / sleep / blocking receive loop), otherwise you will not see push events.
Debugging