Name: 金融交易API
Author: longportapp

使用说明

Longport OpenAPI SDK

Longport OpenAPI为具有研发能力的投资者提供程序化报价交易界面，并帮助他们根据自己的投资策略构建交易或报价策略分析工具。这些功能分为以下几类：

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

名称	文档	描述
锈	文档	Longport OpenAPI for Rust `(>= 1.89.0)`
python	文档	Python 3的Longport OpenAPI `(>= 3.8)`
Node.js	文档	用于Node.js的Longport OpenAPI `(>= 10)`
Java	文档	Java的Longport OpenAPI `(>= 11)`
C	文档	C语言的Longport OpenAPI `(>= C99)`
C	文档	C语言的Longport OpenAPI++`(>= C++17)`
去		https://github.com/longportapp/openapi-go
主控程序		Longport OpenAPI的MCP服务器实现

上下文	描述
`QuoteContext`	实时报价、烛台、期权、认股权证、观察名单、推送订阅
`TradeContext`	订单、头寸、账户余额、执行情况、现金流
`AssetContext`	账户对账单下载
`ContentContext`	新闻、社区话题
`FundamentalContext`	财务报告、分析师评级、股息、估值、公司概述、股东
`MarketContext`	市场状态、经纪商持有量、A/H溢价、交易统计、异常警报、指数成分
`CalendarContext`	财务日历（收益、股息、拆分、首次公开募股、宏观数据、市场收盘）
`PortfolioContext`	汇率、投资组合损益分析
`AlertContext`	价格预警管理（添加/启用/禁用/删除）
`DCAContext`	美元成本平均计划管理
`SharelistContext`	社区共享列表管理

从上表中选择一个语言SDK，并按照其README进行安装和首次请求。完整参考文件：https://longportapp.github.io/openapi

https://longportapp.github.io/openapi

环境变量未生效
- macOS/Linux： export ... 仅影响当前的shell会话。
- 窗户： 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客户端示例开始。

锈蚀：

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.
如果超时/无法连接，请检查代理/防火墙和端点环境变量。

根据以下任一方式获得许可