免费的 WebSocket 股票 API
实时数据接入指南

只通过供应商文档规定的安全握手或首条消息传递 API Key，并始终使用 wss:// 加密连接。

只订阅界面真正需要的股票代码与事件类型。通配符订阅很容易快速耗尽免费消息量或股票代码额度。

把供应商字段映射为稳定的内部模型，包括代码、事件类型、价格、数量、交易所、供应商时间戳与接收时间。

把建立连接、完成鉴权和订阅成功视为三个独立状态。只有供应商明确确认频道后，才能把该股票标记为在线。

保存序号、分区或频道、事件 ID、更正标记，以及来源和接收时间。仅按客户端到达顺序处理并不可靠。

由后端连接供应商，再把标准化更新分发给浏览器；这样既保护密钥，也避免每位用户都建立供应商连接。

使用带抖动的指数退避并设置最大等待时间，鉴权成功后再重新订阅，同时遵守供应商的重试指引。

区分未连接、连接中、鉴权中、订阅中、在线、陈旧、恢复中和已停止状态，并为每个状态设置超时，避免半开连接被误判为健康。

序号缺失时暂停依赖连续状态的消费者，通过 REST 快照或有限重放补齐，再从已知事件继续，并记录修复区间。

使用有界队列，并提前规定消费者落后时采用丢弃、合并、落盘还是断开策略。无限缓冲只会把延迟问题变成内存故障。

按稳定事件身份去重，并明确处理更正，避免重连后的重放重复增加成交数、成交量、提醒或 K 线。