LongPort OpenAPI

Longport OpenAPI SDK

Longport OpenAPI 为具备研究和开发能力的投资者提供程序化行情和交易接口，帮助他们基于自身投资策略构建交易或行情策略分析工具。功能分为以下类别：

• 交易 - 创建、修改、撤销订单，查询当日及历史订单和成交详情等。
• 行情 - 实时行情、获取历史行情等。
• 投资组合 - 实时查询账户资产、持仓和资金
• 实时订阅 - 提供实时行情，以及订单状态变更的推送通知

此仓库包含以下主要组件：

名称	文档	描述
Rust	文档	Longport OpenAPI for Rust (>= 1.89.0)
Python	文档	Longport OpenAPI for Python 3 (>= 3.8)
Node.js	文档	Longport OpenAPI for Node.js (>= 10)
Java	文档	Longport OpenAPI for Java (>= 11)
C	文档	Longport OpenAPI for C (>= C99)
C++	文档	Longport OpenAPI for C++(>= C++17)
Go		https://github.com/longportapp/openapi-go
MCP		Longport OpenAPI 的 MCP 服务实现

上下文类型

上下文	描述
QuoteContext	实时行情、K 线、期权、权证、自选列表、推送订阅
TradeContext	订单、持仓、账户余额、成交、资金流水
AssetContext	下载账户结单
ContentContext	新闻、社区话题
FundamentalContext	财务报告、分析师评级、股息、估值、公司概览、股东
MarketContext	市场状态、券商持仓、A/H 溢价、交易统计、异常警报、指数成分股
CalendarContext	财务日历（财报、股息、拆股、IPO、宏观数据、市场休市）
PortfolioContext	汇率、投资组合盈亏分析
AlertContext	价格提醒管理（添加／启用／禁用／删除）
DCAContext	定期定额投资计划管理
SharelistContext	社区自选列表管理

快速开始

从上表中选择一种语言的 SDK，并按照对应的 README 安装并发送第一个请求。完整参考文档：https://longportapp.github.io/openapi

SDK 文档

https://longportapp.github.io/openapi

故障排除

• 环境变量未生效
  • macOS/Linux：export ... 仅对当前 Shell 会话生效。
  • Windows：setx ... 需要打开新的终端/会话才能生效。
• 身份验证错误（401/403）
  • 确认 LONGPORT_APP_KEY、LONGPORT_APP_SECRET、LONGPORT_ACCESS_TOKEN 正确且未过期。
  • 确保你的 OpenAPI 应用具有所需权限。
• 网络/连接错误
  • 检查 HTTPS/WSS 的防火墙/代理规则。
  • 如果使用自定义端点，请设置 LONGPORT_HTTP_URL、LONGPORT_QUOTE_WS_URL、LONGPORT_TRADE_WS_URL。
• 行情订阅立即退出
  • 保持进程运行（事件循环 / 休眠 / 阻塞式接收循环），否则你将看不到推送事件。
• 调试
  • 通过 LONGPORT_LOG_PATH 启用日志。
  • 如果行情已连接但看起来没有数据，请保留 LONGPORT_PRINT_QUOTE_PACKAGES=true，以确认已打开行情数据包。

最小化验证

如果不确定环境/凭据是否正确，请从内置 HTTP 客户端示例开始。

• 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（从示例模块目录运行）：

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

• C/C++：

  • 使用 examples/c/http_client/main.c 和 examples/cpp/http_client/main.cpp 中的源码。
  • 构建说明取决于你的工具链；请参阅对应语言的 SDK README。

预期结果：

• 如果凭据有效且网络可访问，HTTP 调用将返回 JSON。
• 如果返回 401/403，请检查你的 LONGPORT_APP_KEY、LONGPORT_APP_SECRET、LONGPORT_ACCESS_TOKEN。
• 如果请求超时/无法连接，请检查代理/防火墙和端点环境变量。

资源

• Longport OpenAPI
• Longport OpenAPI 文档

许可证

可选择采用以下任一许可证：

• Apache License，Version 2.0（LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0）
• MIT license（LICENSE-MIT 或 http://opensource.org/licenses/MIT）。