爆仓与价格数据流

通过一条 WebSocket 连接推送逐笔爆仓记录和价格更新。无需发送订阅消息：服务器在连接建立时发送一个 `history` 帧和一个 `price_snapshot` 帧，随后在事件发生时发送 `liquidation` 帧和 `price` 帧。

WSwss://www.coinboss.com/ws

请求

无需发送订阅消息：连接建立后服务器立即开始推送。连接关闭后请延迟重连，并通过 HTTP 回补缺口。

# WebSocket needs a WS client; with websocat:
websocat "wss://www.coinboss.com/ws"

帧类型	发送时机	消息格式
history	一次，在连接时	{ "type": "history", "data": [ <liquidation>, ... ] }
price_snapshot	一次，在连接时	{ "type": "price_snapshot", "data": { "<SYMBOL>": <price>, ... }, "ts": <ms> }
liquidation	每笔爆仓记录	{ "type": "liquidation", "data": <liquidation> }
price	每次价格变动	{ "type": "price", "symbol": "BTCUSDT", "price": <number>, "ts": <ms> }

最近一次成功的响应过大，无法展示，因此未保存示例。请在 Playground 中调用该端点。

可用检查于 2026-11-13 03:53:49 UTCHTTP 1014 ms未校验结构

407 次检查中 100% 通过

所有端点的失败响应格式一致。完整列表见错误页面。错误与速率限制 →

错误码	HTTP	含义	处理方式
INVALID_PARAM	400	缺少必填参数，或某个取值不被接受。已知是哪个参数时，`param` 会给出其名称。	请勿原样重试；请修正请求。
UNAUTHORIZED	401	已发送 `CB-API-KEY` 请求头，但该密钥未知或已被吊销。公开数据无需密钥，请去掉该请求头或使用有效密钥。	请勿原样重试。
FORBIDDEN	403	该路由不属于公开 API（内部或仅限账户使用）。	请勿重试。
NOT_FOUND	404	未知路由，或所请求的币种 / 交易所 / 基金不存在。	请勿重试；请对照目录检查路径和标识符。
RATE_LIMITED	429	请求数超过每分钟限额。`Retry-After` 给出需要等待的秒数。	等待 `Retry-After` 指定的时间后，再以退避方式重试。
INTERNAL	500	意外的服务器错误。错误信息有意保持通用；报告问题时请附上 `request_id`。	几秒后重试一次；若问题持续，请附上请求 ID 报告。
UPSTREAM_FAILED	503	该端点背后的数据源未及时响应。不会返回过期数据或替代数值来顶替。	以退避方式重试；并查看状态页。
UNAVAILABLE	501 / 503	数据集暂时未就绪（缓存预热中），或该端点尚无合法的公开数据源。	请稍后重试；目录会标出因设计原因而不可用的端点。
REQUEST_FAILED	200	部分较旧的端点会以 HTTP 200 返回 `success: false`。请务必检查 `success`，而不只是 HTTP 状态码。	取决于具体信息；按请求失败处理。

WS/ws可用

这是一个 WebSocket 数据流。连接后可查看真实消息的到达情况；收到 25 条消息后连接会自动关闭。

请求 URLwss://www.coinboss.com/ws

响应

选择一个端点，然后点击“发送请求”。响应、响应头和耗时将显示在这里。