Alpaca 券商 SSE 事件

要解决的问题

券商账户里的订单和账户事件会频繁发生：一次成交、一次拒绝、一次状态变更，都是一条事件。用 REST 轮询去拿这些数据，延迟和请求量都是问题——轮得慢了跟不上真实发生的速度，轮得快了大部分响应都是空的。Alpaca 的做法是通过 Server-Sent Events 主动推送这些生命周期事件，客户端只需要保持一条连接就能持续收到更新。

技能如何工作

核心是一条长连接的 HTTP GET 请求，响应类型为 text/event-stream，不需要任何特殊客户端。服务端持续写出事件流，客户端逐行读取，每条事件的 data: 字段承载一个 JSON 对象。

关键能力包括：

• 可回放：可以从过去某个时间点开始请求事件，系统先补发历史事件，再无缝衔接到实时流，这对补齐断线期间的数据非常有用
• 标准 HTTP 认证：使用 Broker API host 加 HTTP Basic auth，和 Broker REST 接口共用同一组凭证
• 轻量传输：相比 WebSocket，SSE 不需要额外的握手协议和帧解析，用标准 HTTP 栈即可处理，调试也更直接

注意点

• SSE 和 Alpaca 的行情 WebSocket 是两条完全独立的通道：传输方式、认证方式、可靠性模型都不一样，不要混用
• 使用前建议先了解 Broker integration 的基础概念
• 长连接会断，需要设计重连和断点续传的逻辑，SSE 的回放能力正好可以补上这个缺口