Bitget: canais kline e publicTrade da API V3 deixam de enviar snapshot em 17/11 (como carregar os candles antes)
A partir de 17 de novembro de 2026, os canais públicos kline e publicTrade do WebSocket V3 (UTA) da Bitget deixam de enviar a mensagem inicial com action=snapshot depois da inscrição. Você só vai receber mensagens action=update. A mudança já está ativa no ambiente demo desde 4 de novembro, e a própria documentação da Bitget recomenda buscar o histórico via REST.
Se o seu código monta o array de candles a partir desse primeiro snapshot, ele vai começar vazio em produção a partir de segunda-feira. A correção é simples: carregue os candles recentes via REST e depois aplique as atualizações do stream por cima.
Exemplo com o bitget-api, nosso SDK open source (MIT) para Node.js e TypeScript. Aviso: eu ajudo a manter esse pacote. Ele é dos mesmos mantenedores dos SDKs JavaScript binance, bybit-api e okx-api, que somam mais de 4,5 milhões de downloads no npm em mais de 10 SDKs.
npm install bitget-api
import { RestClientV3, WebsocketClientV3, WS_KEY_MAP } from 'bitget-api';
const rest = new RestClientV3();
const ws = new WebsocketClientV3({});
// 1. Carrega o histórico via REST
const seed = await rest.getCandles({
category: 'SPOT',
symbol: 'BTCUSDT',
interval: '1m',
limit: '100',
});
console.log('candles carregados:', seed.data.length);
// 2. Aplica as atualizações ao vivo por cima
ws.on('update', (event) => {
// event.action agora é sempre 'update'; faça o merge pelo horário de abertura do candle
console.log(event.action, JSON.stringify(event.data));
});
ws.on('reconnected', ({ wsKey }) => {
// depois de reconectar, recarregue via REST, porque não há snapshot
console.log('reconectado', wsKey);
});
ws.subscribe(
{ topic: 'kline', payload: { instType: 'spot', symbol: 'BTCUSDT', interval: '1m' } },
WS_KEY_MAP.v3Public,
);
A mesma ideia vale para o publicTrade: se precisar dos trades recentes, busque via REST primeiro.
Duas observações:
- O SDK reconecta e refaz as inscrições sozinho, mas sem snapshot qualquer lacuna durante a reconexão precisa ser preenchida via REST. Recarregar no evento reconnected é o jeito mais simples.
- Faça o merge dos candles pelo horário de abertura em vez de só adicionar no fim, porque o candle atual é atualizado várias vezes antes de fechar.
Links:
- Tutorial da API da Bitget em JavaScript: https://siebly.io/sdk/bitget/javascript/tutorial
- Referência do WebsocketClientV3: https://sieblyio.github.io/docs/bitget/api/classes/WebsocketClientV3.html
- Referência do RestClientV3: https://sieblyio.github.io/docs/bitget/api/classes/RestClientV3.html