3

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:

Carregando publicação patrocinada...