Listagem de Cripto API de Anúncios

Uma API WebSocket em tempo real para anúncios e avisos de listagem das corretoras cripto. Conecte-se e receba alertas JSON estruturados para avisos de listagem da Binance, Upbit, Bithumb.

Visão geral da API

O CryptoListing.ws fornece dois endpoints de despacho WebSocket que transmitem anúncios e avisos de listagem em tempo real de várias corretoras de criptomoedas. A API é projetada para sistemas de trading automatizado que precisam da notificação mais rápida possível de novos anúncios de listagem das corretoras. A mesma chave de API autentica nos dois endpoints — escolha pela localização do seu bot.

Formato da mensagem

Cada mensagem de anúncio contém o ticker, a corretora, o tipo de listagem e três timestamps com precisão de microssegundos:

{
  "type": "announcement",
  "title": "Binance Will List TOKEN (TOKEN)",
  "ticker": "TOKEN",
  "publisher": "binance",
  "listingType": "spot_listing",
  "detectedTimestampUs": 1710345000005000,
  "dispatchTimestampUs": 1710345000006000
}

Tipos de listagem

Filtragem por corretora

Use o parâmetro de consulta ?cex= no endpoint de Tóquio para assinar apenas corretoras específicas. O endpoint de Seul já transmite exclusivamente os anúncios da Upbit, então o filtro é opcional ali.

wss://cryptolisting.ws                       // Tóquio: todas as corretoras (Binance, Upbit, Bithumb)
wss://cryptolisting.ws?cex=binance             // Tóquio: apenas binance
wss://cryptolisting.ws?cex=binance,upbit       // Tóquio: binance + upbit
wss://kr.cryptolisting.ws                    // Seul: apenas Upbit (ultrarrápido a partir da Coreia)

Medição de latência

Cada anúncio inclui dois timestamps em microssegundos desde o epoch UNIX. Calcule sua latência:

dispatch_delay  = dispatchTimestampUs - detectedTimestampUs
network_delay   = your_receive_time  - dispatchTimestampUs
total_latency   = your_receive_time  - detectedTimestampUs

Por que escolher esta API de anúncios de listagem?

Diferente de APIs REST baseadas em polling ou de bots do Telegram, nossa API WebSocket entrega avisos de listagem no instante em que são detectados. O broadcast zero-copy significa que a mensagem do anúncio é serializada uma vez e compartilhada entre todos os assinantes — sem sobrecarga de serialização por cliente. Essa arquitetura alcança latência de despacho ultrarrápida e consistente independentemente do número de assinantes. Leia mais sobre corretoras específicas: avisos de listagem da Binance, anúncios de listagem da Upbit, avisos de listagem da Bithumb.

FAQ

Qual protocolo a API usa?

WebSocket (RFC 6455) sobre TLS 1.2+. A autenticação é feita pelo header HTTP X-API-Key na requisição de upgrade. As mensagens são JSON UTF-8 em frames binários. A mesma chave de API autentica nos dois endpoints — escolha pela localização do seu bot, não pela corretora em que você opera.

Quais corretoras são suportadas?

Binance (listagens spot, listagens de futuros, delistagens, HODLer airdrops, tag de monitoramento estender / remover), Upbit e Bithumb (listagens spot no mercado KRW, liberações de cautela e delistagens spot — os estágios acionáveis do ciclo de cautela coreano). Mais corretoras são adicionadas conforme a demanda dos assinantes. Use o parâmetro de consulta ?cex= no endpoint de Tóquio para filtrar.

Como eu autentico?

Inclua o header X-API-Key na requisição de upgrade do WebSocket. Consiga sua chave falando com a gente no Telegram em @CLWfeed. A mesma chave funciona nos dois endpoints. Veja a documentação de Autenticação para exemplos de código.

Qual é a latência da mensagem?

A latência de despacho é ultrarrápida. Cada anúncio carrega os campos detectedTimestampUs e dispatchTimestampUs com precisão de microssegundos, para que você meça o desempenho de ponta a ponta de forma independente. A latência de rede depende da localização do seu bot: hosts na AWS Tóquio (ap-northeast-1a - apne1-az4) obtêm a menor latência de ponta a ponta até o endpoint de Tóquio, e hosts na AWS Seul (ap-northeast-2c - apne2-az3) até o endpoint de Upbit em Seul.

Como os dois endpoints diferem?

wss://cryptolisting.ws (Tóquio) transmite o feed completo e é o endpoint global padrão. wss://kr.cryptolisting.ws (Seul) transmite apenas Upbit e é otimizado para bots de trading colocalizados na Coreia — elimina o salto de rede Seul→Tóquio no lado da detecção. Limites de conexão e de taxa são rastreados de forma independente por endpoint.

O que acontece se a conexão cair?

O servidor envia um heartbeat a cada 30 segundos; os clientes devem enviar pings de WebSocket na mesma cadência. Na desconexão, reconecte com backoff exponencial (normalmente começando em 1s, dobrando até 30s). Listagens emitidas enquanto você estava desconectado NÃO são reenviadas — para uma trilha de auditoria de detecções passadas, veja as últimas detecções.