Alpaca券商交易订单

解决的问题

当Agent需要代表最终用户操作Alpaca券商账户时，直接调用原生API会遇到两个核心问题：一是难以清晰区分“为不同用户账户操作”的边界，二是缺少统一的交易流程与参数规范。该技能将Broker API的核心交易能力封装为标准化操作，解决了多用户账户场景下的交易执行与数据查询难题。

核心能力与工作步骤

• 账户路径强制隔离：所有交易操作均在路径中包含account_id（如/v1/trading/accounts/{account_id}/orders），明确表示“为某个用户账户操作”，与独立Trading API（/v2/orders，无账户路径）形成关键区分。
• 完整的交易生命周期管理：支持通过POST创建订单，以及修改、取消、查询订单，同时可读取账户持仓和购买力，覆盖交易全流程操作。
• 认证与集成依赖：需基于Broker API并使用HTTP Basic auth进行认证，操作前需先阅读alpaca-broker-integration指南，确保与券商系统的认证配置正确。

适用边界与注意事项

• 仅适用于Broker API场景，独立Trading API的/v2/orders路径不适用，但核心交易逻辑可迁移。
• 需要预先获取有效的account_id并配置HTTP Basic auth凭证，否则无法通过API认证。
• 交易类型需符合Alpaca文档规范（如支持分数股交易），具体规则需参考官方指南。