跳转到内容

OpenAPI 介绍

LongPort Developers 提供 OpenAPI、SDK、MCP、Skill 和适合 LLM 读取的文档入口,用于构建行情、资产组合、交易和 AI agent 工作流。

你可以直接使用 HTTP / WebSocket API,也可以通过 SDK 集成,或通过 LongPort Skill、MCP、LLMs Text 将 AI 工具接入 LongPort Developers。

可以构建什么

LongPort Developers 为有研发能力的投资者和开发者提供程序化行情交易接口,覆盖以下能力:

  • 交易类 - 创建、修改、撤销订单,当日/历史订单及成交记录的查询等
  • 行情类 - 实时行情报价、历史行情数的获取等
  • 资产类 - 实时账户资产、持仓、现金查询等
  • 实时订阅 - 提供行情实时报价以及订单状态实时变更信息推送

接入方式

方式适用场景入口
OpenAPI直接通过 HTTP 和 WebSocket 构建行情、账户和交易系统快速开始
SDK使用支持的语言开发应用,避免手写协议细节SDK
Skill让 AI 助手获得可复用的 LongPort 工作流知识和安全安装引导Skill
MCP将支持 MCP 的 AI 客户端通过 HTTP 接入 140+ LongPort Developers toolsMCP
LLMs Text通过 llms.txtllms-full.txt 和单页 Markdown 向 AI 工具提供文档LLMs Text

如何开通

  1. 登录 LongPort App 完成开户;
  2. 登录 longportapp.com 进入开发者平台,完成开发者认证即 OpenAPI 权限申请,获取令牌。

行情覆盖

市场标的
港股证券类产品(含股票、ETFs、窝轮、牛熊、界内证)
恒生指数
美股证券类产品(含纽交所、美交所、纳斯达克上市的股票、ETFs)
纳斯达克指数
OPRA 期权
A 股证券类产品(含股票、ETFs)
指数

交易标的类别

目前 OpenAPI 支持交易一下标的类别:

市场股票 ETF权证期权
香港市场
美国市场

频率限制

类别限制规则
行情相关 API
  • 一个账号同时只能建立一个长连接,最多同时订阅 500 个标的
  • 1 秒内不超过 10 次调用,并发请求数不超过 5
交易相关 API
  • 30 秒内累计不超过 30 次调用,且每两次调用之间间隔不小于 0.02 秒
Success

我们 OpenAPI SDK 内部已经做了有效的频率控制:

  • 行情类:QuoteContext 下的接口,SDK 内部会按照服务端的频率限制来主动控制,当请求过快的时候,SDK 会自动延迟请求。因此你可以不需要额外实现频率控制细节。
  • 交易类:TradeContext 下的接口,SDK 没有做限制,由于交易下单场景特殊性,将这个交由用户自行处理。

使用费用

LongPort 不针对接口服务额外收取开通或使用费用,只需开通 LongPort 账户及 OpenAPI 服务权限后即可免费使用。实际交易费率请咨询您开通证券账户的券商。

其他

OpenAPI 服务由 LongPort 及其适用的关联公司提供(具体以协议为准)。