用途:通过 Alpaca Broker API 代表终端用户账户下单、改单、撤单、查询订单,并读取持仓与购买力。与独立 Trading API 不同,Broker API 的 account_id 在路径中,需 HTTP Basic 认证,使用前应先阅读 alpaca-broker-integration。
主要能力:订单端点包括 POST /v1/trading/accounts/{id}/orders 创建、GET 列表与按 ID 查询、按 client_order_id 查询、PATCH 替换、DELETE 单个(204)或全部(207)、POST estimation 成本估算;另有持仓列表/平仓与交易账户详情。创建订单时 type 与 time_in_force 必填,symbol、side 及 qty/notional 二选一(同时传会 400)。支持 market、limit、stop、stop_limit、trailing_stop,TIF 支持 day、gtc、opg、cls、ioc、fok,order_class 支持 simple、bracket、oco、oto、mleg。
用法要点:分数股/名义金额默认开启,资产需 fractionable: true,TIF 必须为 day,名义金额仅限 market 与 limit(day),扩展时段仅限 limit;qty 与 notional 精度最多 9 位小数,不支持做空分数股。订单状态含 new、accepted、pending_new、filled、canceled、rejected 等,终态为 filled、canceled、expired、rejected;应持久化订单并依赖 SSE 交易事件流更新,而非同步阻塞等待终态。建议始终设置 client_order_id 作为幂等键,并在名义金额下单前检查 buying_power/cash。
限制与注意:自成交会被 403 拒绝,可用 bracket/oco/trailing_stop 规避;bracket 需同时提供 take_profit.limit_price 与 stop_loss.stop_price,且不支持扩展时段;名义金额订单不可替换,需撤单重下;PATCH 返回 200 仍可能因原单先成交而被拒;PDT/日内交易字段已弃用。相关技能包括行情与时钟、SSE 事件、限流与金额精度。