Alpaca 交易与券商 API 库

要解决什么问题

在 Alpaca 上做自动化交易或代客经纪集成时，REST 路径、订单字段和状态机细节很容易踩坑：qty 与 notional 互斥、碎股 TIF 限制、洗单 403、替换订单与 SSE 终态不同步等。单靠 API 文档很难让 Agent 在对话里稳定走完「下单 → 跟踪 → 对账」整条链路。

技能如何组织

本库为 Trading API（自有账户）与 Broker API（路径中带 account_id、代客操作）各提供一组代理技能。每个技能是 SKILL.md（工作流）+ reference.md（模式、公式、CLI） 的文件对，命名形如 alpaca-trading-backtest、alpaca-broker-trading-orders。

Broker 侧覆盖典型运维面：

• trading-orders：POST /v1/trading/accounts/{id}/orders，强调 client_order_id 幂等、订单状态生命周期（accepted → new → filled/canceled/rejected）
• market-data、account-onboarding、funding-transfers、reconciliation-idempotency、rate-limits-resilience、money-precision、journals、sse-events、integration

Trading 侧目前有 backtest 等策略回测相关技能；目录上 skills/trading-api/ 与 skills/broker-api/ 分开，便于按场景选用。

边界与注意点

• 密钥：只用环境变量（如 ALPACA_API_KEY），禁止硬编码；交易类输出需带免责声明。
• 订单：名义金额订单通常不可直接 replace，需取消后重提；bracket/oco/trailing_stop 用于降低自成交洗单风险。
• 碎股：TIF 必须为 day，且需确认资产 fractionable；碎股不支持做空。
• 状态：new/accepted/pending_new 可统一视为「已提交未完成」，终态以 SSE 事件流为准，少靠轮询。
• 合规字段：PDT/日内交易相关字段自 2026-04-27 起废弃，新集成勿再依赖。