Agent Skills
返回列表
⚖️

Alpaca 交易券商 API 套件

行业专业 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/alpaca-skills。

技能介绍

要解决什么问题

把 Alpaca 的 REST 接口接进 Agent 工作流时，失败通常不在鉴权，而在订单语义：qty 和 notional 同时传返回 400，碎股单用了非 day 的 TIF，自成交触发洗单拒绝（403），或者撤单替换之后才发现原单已经成交。这套技能库把这类规则固化成可直接调用的工作流，而不是每次都重新查一遍文档。

技能如何工作

技能按 API 分成两组：skills/trading-api/ 面向自有账户交易，skills/broker-api/ 面向代客操作，account_id 出现在路径里，Agent 代表用户账户执行。每个技能是一对文件：SKILL.md 描述工作流，reference.md 补充模式、公式与 CLI 细节。

Broker API 侧覆盖交易订单管理、市场数据（报价、快照、K 线、交易流）、账户开通（KYC 与文档提交）、资金转账、对账与幂等性、速率限制与弹性、金额精度、内部转账日志、SSE 事件流、认证集成；Trading API 侧提供 backtest 策略回测框架。

订单管理技能的核心是 POST /v1/trading/accounts/{id}/orders，并明确状态生命周期：accepted 已接收未路由，new 已路由到交易所，partially_filled 部分成交，filled、canceled、rejected 为终态。落地时按清单执行：API 密钥走环境变量 ALPACA_API_KEY 与 ALPACA_SECRET_KEY，设置 client_order_id 作为幂等键，用 SSE 事件流跟踪状态而非轮询。

适用边界与注意点

这套技能只绑定 Alpaca 的 Trading API 与 Broker API。Broker 路径下的操作属于代客交易，技能要求输出中附带免责声明。碎股交易必须 TIF: day 且资产 fractionable: true，并且不支持做空。bracket、oco、trailing_stop 可避免自成交，但名义订单取消后只能重新提交，替换也不保证成功。自 2026-04-27 起 PDT/日内交易相关字段已废弃，不应再依赖。

使用场景

  • 搭建基于 Alpaca Broker API 的代客交易系统，需完成客户开户并完成订单下单与状态跟踪任务。
  • 编写算法交易策略时，需用 Trading API backtest 技能跑历史数据回测并输出绩效结果。
  • 处理客户资金转入转出需求，需用 funding-transfers 技能发起 ACH 转账并审计 journals 日志。
  • 开发实时行情监控模块，需订阅 SSE 事件流处理交易订单与账户更新并拉取 K 线数据。

适合人员

  • 后端开发者，想把 Alpaca API 接入交易机器人，减少重复的参数校验与状态处理出错。
  • 量化研究员，想快速验证交易策略有效性，借助 alpaca-trading-backtest 跑历史回测。
  • 券商技术对接工程师，需确保代客订单的幂等安全与合规对账，减少人工核查成本。
  • 自动化运维工程师，需监控交易 SSE 事件流与账户资金变动，保证交易系统稳定运行。