mcpField
L
longbridge

longbridge

github.com/starchild-ai-agent其他2969 次安装1 周前更新
代码仓库

关于 longbridge

通过 Longport SDK 查询和交易美股、港股及 A 股的命令行技能，提供账户与行情操作。模拟或实盘环境取决于配置的令牌，服务端不会进行环境校验。

主要功能

  1. 01账户状态与资产检查
  2. 02查询报价和历史行情
  3. 03查看持仓与订单
  4. 04提交市价或限价单
  5. 05实盘下单需额外确认

适用场景

  1. 01使用前检查账户状态
  2. 02查看持仓和成交记录
  3. 03获取股票报价或历史行情
  4. 04核对配置令牌后提交订单

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill longbridge

安装后在 Claude Code 中输入/longbridge确认已加载。

附带文件scripts/longbridge_cli.py

详细介绍

这是什么

☁️ 云端代理 — 通过官方 longport SDK（原 longbridge）直接在容器内运行。覆盖美股、港股和 A 股市场。

认证采用静态密钥：App Key + App Secret + Access Token。这些使用 SDK 自身的环境变量名称，因此会被自动读取。

⚠️ API 中不存在模拟/实盘判别字段。 模拟与实盘仅由你加载的 Access Token 决定 —— 没有任何字段、账户前缀或主机名可以区分它们。因此这里的 --profile 是信任声明（会原样回显为 paper_guard: config_declared）；它不会在服务端验证任何内容。实盘下单仍需 --confirm-live。请将你配置的 token 视为所处环境的权威依据。

获取你的凭证

  1. 开通 Longbridge 账户，然后前往 LongPort OpenAPI 控制台（开放平台）。
  2. 申请 / 启用 OpenAPI 访问权限。控制台会签发三个值：
    • App Key
    • App Secret
    • Access Token（有有效期 —— 过期后请重新生成）
  3. 如需模拟交易，请在你的账户/环境处于平台提供的模拟模式时生成 token；如需实盘，请使用实盘 token。（两种情况下字段名相同。）

配置（.env）

通过安全输入方式请求 —— 切勿在聊天中粘贴密钥。以下是 SDK 的标准名称：

变量必需说明
LONGPORT_APP_KEY是App Key
LONGPORT_APP_SECRET是App Secret
LONGPORT_ACCESS_TOKEN是Access Token（会过期 —— 需要时刷新）

用法

pip install longport（首次运行）。JSON 输出。默认 profile 为 paper（仅为标签）。

python skills/longbridge/scripts/longbridge_cli.py status
python skills/longbridge/scripts/longbridge_cli.py account
python skills/longbridge/scripts/longbridge_cli.py positions
python skills/longbridge/scripts/longbridge_cli.py orders [--executions]
python skills/longbridge/scripts/longbridge_cli.py quote --symbol 700.HK
python skills/longbridge/scripts/longbridge_cli.py history --symbol AAPL.US --period 1d --limit 90
# place: qty in shares only; market or limit
python skills/longbridge/scripts/longbridge_cli.py place --symbol 700.HK --side buy --qty 100 --type limit --limit-price 350
python skills/longbridge/scripts/longbridge_cli.py cancel --order-id <id>
# live (real money): add --confirm-live (profile is label-only)
python skills/longbridge/scripts/longbridge_cli.py --confirm-live place --symbol AAPL.US --side buy --qty 1

代码格式为必填： <ticker>.<market> —— 700.HK、AAPL.US、000001.SZ、600519.SH。周期：1m 5m 15m 30m 1h 1d 1w 1M。

注意事项

  • Longbridge 没有名义金额路径 —— 始终使用 --qty（股数）。
  • Access Token 会过期；如果调用开始出现认证失败，请在控制台重新生成并更新 .env。
  • 由于服务端没有模拟/实盘检查，在任何实盘下单前请仔细确认你加载的是哪个 token —— 命令行无法替你识别标错环境的 token。

评论

支持 Markdown