Fluxo de liquidações e preços

Uma única conexão WebSocket envia registros de liquidação e atualizações de preço. Não há mensagem de assinatura: o servidor envia um frame `history` e um frame `price_snapshot` na conexão e, em seguida, frames `liquidation` e `price` à medida que os eventos ocorrem.

WSwss://www.coinboss.com/ws

Requisição

Não há mensagem de assinatura: o servidor começa a enviar assim que a conexão é aberta. Quando o socket fechar, reconecte após um intervalo e preencha a lacuna via HTTP.

Exemplo de requisição

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

Campos da resposta

Tipo de frame	Enviado	Formato
history	uma vez, na conexão	{ "type": "history", "data": [ <liquidation>, ... ] }
price_snapshot	uma vez, na conexão	{ "type": "price_snapshot", "data": { "<SYMBOL>": <price>, ... }, "ts": <ms> }
liquidation	a cada registro de liquidação	{ "type": "liquidation", "data": <liquidation> }
price	a cada mudança de preço	{ "type": "price", "symbol": "BTCUSDT", "price": <number>, "ts": <ms> }

Exemplo de resposta

Nenhum exemplo está armazenado porque a última resposta bem-sucedida era grande demais para exibir. Chame o endpoint no Playground.

Detalhes

Autenticação: Nenhuma. Endpoint público.
Limite de requisições: 1200 requisições por minuto por IP
Cache do servidor: Sem cache
Frequência de atualização: Enviado em tempo real. Os frames `liquidation` acompanham os feeds de liquidação das corretoras; os frames `price` acompanham as atualizações dos tickers de futuros.
Janela: `history` contém os registros de liquidação mais recentes no momento da conexão; todo o resto é ao vivo.
Fontes de dados: Feeds de liquidação das corretoras coletados pela CoinBoss; stream de tickers de futuros.
Timestamps: Milissegundos da época Unix (UTC) em `ts` / `timestamp`.
Formato da resposta: json-frames
Estabilidade: Estável

Status ao vivo

DisponívelVerificado 2026-11-13 03:59:35 UTCHTTP 1014 msEsquema não verificado

Disponibilidade, últimos 30 dias

100% de 408 verificações aprovadas

Erros

As chamadas com falha têm o mesmo formato em todos os endpoints. A lista completa está na página de erros. Erros e limites de requisições →

Código	HTTP	Significado	O que fazer
INVALID_PARAM	400	Falta um parâmetro obrigatório ou um valor não é aceito. `param` indica o nome do parâmetro quando ele é conhecido.	Não repita a requisição sem alterações; corrija-a.
UNAUTHORIZED	401	O cabeçalho `CB-API-KEY` foi enviado, mas a chave é desconhecida ou foi revogada. Dados públicos não exigem chave — remova o cabeçalho ou use uma chave válida.	Não repita a requisição sem alterações.
FORBIDDEN	403	A rota não faz parte da API pública (é interna ou exclusiva de conta).	Não tente novamente.
NOT_FOUND	404	Rota desconhecida, ou a moeda / corretora / fundo solicitado não existe.	Não tente novamente; confira o caminho e os identificadores no catálogo.
RATE_LIMITED	429	Mais requisições do que o limite por minuto. `Retry-After` informa os segundos a aguardar.	Aguarde `Retry-After` e então tente novamente com backoff.
INTERNAL	500	Erro inesperado do servidor. A mensagem é genérica de propósito; cite `request_id` ao reportá-lo.	Tente novamente uma vez após alguns segundos; se persistir, reporte-o com o ID da requisição.
UPSTREAM_FAILED	503	A fonte de dados por trás deste endpoint não respondeu a tempo. Nenhum número desatualizado ou substituto é retornado em seu lugar.	Tente novamente com backoff; consulte a página de status.
UNAVAILABLE	501 / 503	O conjunto de dados ainda não está pronto temporariamente (aquecimento do cache) ou o endpoint ainda não tem uma fonte pública lícita.	Tente novamente mais tarde; o catálogo marca os endpoints que são indisponíveis por design.
REQUEST_FAILED	200	Alguns endpoints mais antigos respondem HTTP 200 com `success: false`. Verifique sempre `success`, não apenas o status HTTP.	Depende da mensagem; trate como uma requisição com falha.

Experimente

WS/wsDisponível

Este é um fluxo WebSocket. Conecte-se para ver mensagens reais chegando; a conexão é encerrada automaticamente após 25 mensagens.

URL da requisiçãowss://www.coinboss.com/ws

Resposta

Escolha um endpoint e clique em “Enviar requisição”. A resposta, os cabeçalhos e o tempo de resposta aparecerão aqui.

Fluxo de liquidações e preços /ws