LongPort OpenAPI SDK

LongPort 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	LongPort OpenAPI for Rust (>= 1.89.0)
Python	Doc	LongPort OpenAPI for Python 3 (>= 3.8)
Node.js	Doc	LongPort OpenAPI for Node.js (>= 10)
Java	Doc	LongPort OpenAPI for Java (>= 11)
C	Doc	LongPort OpenAPI for C (>= C99)
C++	Doc	LongPort OpenAPI for C++(>= C++17)
Go		https://github.com/longportapp/openapi-go
MCP		An MCP server implementation for LongPort OpenAPI

Environment Variables

Name	Description
LONGPORT_LANGUAGE	Language identifier, zh-CN, zh-HK or en (Default: en)
LONGPORT_APP_KEY	App key
LONGPORT_APP_SECRET	App secret
LONGPORT_ACCESS_TOKEN	Access token
LONGPORT_HTTP_URL	HTTP endpoint url (Default: https://openapi.longportapp.com)
LONGPORT_QUOTE_WS_URL	Quote websocket endpoint url (Default: wss://openapi-quote.longportapp.com/v2)
LONGPORT_TRADE_WS_URL	Trade websocket endpoint url (Default: wss://openapi-trade.longportapp.com/v2)
LONGPORT_ENABLE_OVERNIGHT	Enable overnight quote, true or false (Default: false)
LONGPORT_PUSH_CANDLESTICK_MODE	realtime or confirmed (Default: realtime)
LONGPORT_PRINT_QUOTE_PACKAGES	Print quote packages when connected, true or false (Default: true)
LONGPORT_LOG_PATH	Set the path of the log files (Default: no logs)

Quickstart

• Pick a language SDK and follow its README for install + first request:
  • Rust: rust/README.md
  • Python: python/README.md
  • Node.js: nodejs/README.md
  • Java: java/README.md
  • C: c/README.md
  • C++: cpp/README.md
  • Go: https://github.com/longportapp/openapi-go
• Full reference docs: https://longportapp.github.io/openapi

SDK Documentation

https://longportapp.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 LONGPORT_APP_KEY, LONGPORT_APP_SECRET, LONGPORT_ACCESS_TOKEN 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 LONGPORT_HTTP_URL, LONGPORT_QUOTE_WS_URL, LONGPORT_TRADE_WS_URL.
• Quote subscription exits immediately
  • Keep the process running (event loop / sleep / blocking receive loop), otherwise you will not see push events.
• Debugging
  • Enable logs via LONGPORT_LOG_PATH.
  • If quotes connect but look empty, keep LONGPORT_PRINT_QUOTE_PACKAGES=true to confirm opened quote packages.

Minimal Verification

If you're not sure whether your environment / credentials are correct, start with the built-in HTTP client examples.

• Python:

  python examples/python/http_client.py

• Node.js:

  node examples/nodejs/http_client.js

• Rust:

  cargo run --manifest-path examples/rust/Cargo.toml -p http_client

• Java (from the example module directory):

  cd examples/java/http_client
  mvn -q -DskipTests package
  mvn -q -DskipTests exec:java

• C/C++:

  • Use the sources in examples/c/http_client/main.c and examples/cpp/http_client/main.cpp.
  • Build instructions depend on your toolchain; see the corresponding language SDK README.

Expected results:

• If credentials are valid and network is reachable, the HTTP call returns JSON.
• If it returns 401/403, check your LONGPORT_APP_KEY, LONGPORT_APP_SECRET, LONGPORT_ACCESS_TOKEN.
• If it times out / cannot connect, check proxy/firewall and your endpoint env vars.

Resources

• LongPort OpenAPI
• LongPort OpenAPI Docs

License

Licensed under either of

• Apache License, Version 2.0,(LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.