用途 这是一个云端券商技能，通过官方 longport SDK（原 longbridge）直接在容器中运行，覆盖美股、港股和 A 股市场。适用于用户想要查看账户信息、持仓、订单、行情与历史数据，或进行下单、撤单等操作时使用。
主要能力 该技能提供账户、持仓、订单、行情、历史数据查询，以及市价或限价下单和撤单功能。命令输出为 JSON 格式。默认 profile 为 paper，但仅为标签。
使用方式 首先执行 pip install longport 安装依赖。认证采用静态密钥，包括 App Key、App Secret 和 Access Token，使用 SDK 自带的环境变量名以便自动读取。需要配置的变量为：LONGPORT_APP_KEY（必需，App Key）、LONGPORT_APP_SECRET（必需，App Secret）、LONGPORT_ACCESS_TOKEN（必需，Access Token，有有效期，过期后需重新生成）。凭证应通过安全输入方式提供，切勿在聊天中粘贴密钥。
常见命令包括： status account positions orders [--executions] quote --symbol 700.HK history --symbol AAPL.US --period 1d --limit 90 place --symbol 700.HK --side buy --qty 100 --type limit --limit-price 350 cancel --order-id <id> 实盘下单需添加 --confirm-live，例如：--confirm-live place --symbol AAPL.US --side buy --qty 1
代码块示例： pip install longport 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 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> 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。
凭证获取 先开设长桥账户，然后前往 LongPort OpenAPI 控制台（开放平台），申请或启用 OpenAPI 访问权限。控制台会发放三个值：App Key、App Secret、Access Token（有有效期，失效后需重新生成）。如用于模拟交易，需在账户或环境处于平台提供的模拟模式时生成 Token；如用于实盘，则使用实盘 Token。两种情况下三个字段名称相同。
适用场景 适合需要在自动化或容器环境中查询证券账户资产、持仓、订单状态，获取市场行情与历史 K 线，以及执行或撤销交易指令的场景。
限制与注意事项 API 中不存在模拟盘与实盘的判别字段，没有账户前缀或主机可以区分两者，模拟与实盘仅由所加载的 Access Token 决定。因此此处的 --profile 只是信任声明（会以 paper_guard: config_declared 回显），不会在服务端做任何验证。实盘下单仍需要 --confirm-live。应将所配置的 Token 视为判定当前环境的权威依据。长桥没有按金额下单路径，始终需要使用 --qty（股数）。Access Token 会过期，若调用开始出现认证失败，需在控制台重新生成并更新 .env。由于没有服务端模拟盘与实盘检查，实盘下单前务必再次确认所加载的 Token，CLI 无法替你发现环境标注错误。