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 e Robinhood.

Visão geral da API

O CryptoListing.ws fornece três 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 três endpoints — escolha pela localização do seu bot.

Para quem é esta API

• Bots de trading e equipes quant que agem sobre eventos de listagem, deslistagem e cautela e precisam de um gatilho legível por máquina.
• Desenvolvedores de produtos de alerta e dashboards que cobrem Binance, Upbit, Bithumb e Robinhood sem manter uma integração por corretora.
• Pesquisadores que precisam de um histórico de anúncios com timestamps: o feed JSON gratuito e o arquivo de últimas listagens, com uma página e um gráfico de reação do preço por anúncio.
• Não vai programar um bot? Provavelmente você só quer os alertas: siga o canal gratuito no Telegram ou @cryptolistingws no X (EN).

Opções gratuitas

• SpeedTrial — chave WebSocket gratuita no feed de produção com atraso de cortesia de +1 ms; ticker e título ocultos. Feita para benchmark. Chave de 15 dias, renovável sob pedido.
• FreeDelayed — chave WebSocket com o feed completo, ticker e título incluídos, e atraso de +240 ms. Grátis no primeiro mês e depois 200 USDT/mês, com todas as corretoras incluídas.
• Feed JSON público — anúncios recentes em um arquivo estático, sem chave. Não é um stream em tempo real.
• Canal no Telegram e conta no X — alertas gratuitos para leitura.

Os planos pagos — Basic (+20 ms) e Premium (sem atraso) — são cobrados por corretora e por mês em USDT: veja os preços e a calculadora. Toda chave, gratuita ou paga, é emitida sob pedido no Telegram — não há cadastro self-service.

Construir por conta própria ou usar esta API

Você pode coletar os anúncios das corretoras por conta própria. Isso significa criar e manter um coletor para cada corretora, analisar títulos de avisos escritos para pessoas em vários idiomas, classificar cada tipo de aviso e manter tudo funcionando dia e noite quando os formatos mudam. É uma boa escolha se você opera em uma única corretora e quer controlar toda a sua infraestrutura.

Use esta API quando quiser várias corretoras em uma só conexão, um esquema estável com ticker e tipo de evento já extraídos, deslistagens e liberações de cautela classificadas, e eventos da Robinhood.

Formato da mensagem

Cada mensagem de anúncio contém o ticker, a corretora, o tipo de listagem e dois 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
}

A lista completa e atualizada de valores de listingType está documentada na referência de mensagens.

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 transmite Upbit e Bithumb, então o mesmo filtro se aplica ali. A Robinhood é servida apenas pelo endpoint dos EUA, wss://us.cryptolisting.ws, que não transmite nenhuma outra corretora.

wss://jp.cryptolisting.ws                    // Tóquio: Binance, Upbit, Bithumb — Robinhood fica em wss://us.cryptolisting.ws
wss://jp.cryptolisting.ws?cex=binance        // Tóquio: apenas binance
wss://jp.cryptolisting.ws?cex=binance,upbit  // Tóquio: binance + upbit
wss://kr.cryptolisting.ws                    // Seul: Upbit + Bithumb (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.

Vai construir um bot? Siga o tutorial passo a passo de um bot sniper de listagens da Binance em Python (EN). Há também um tutorial de bot de listagens da Upbit e da Bithumb em Python (EN). A referência completa da API cobre a API WebSocket (EN), o esquema das mensagens (EN) e exemplos de código em Python, Node.js, Go e Rust (EN).

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 três 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) e Robinhood (eventos Robinhood Listing e Robinhood Live, servidos por wss://us.cryptolisting.ws). 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 três 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, hosts na AWS Seul (ap-northeast-2c - apne2-az3) até o endpoint de Seul, que transmite Upbit e Bithumb, e hosts na AWS N. Virginia (us-east-1a - use1-az1) até o endpoint dos EUA, que transmite a Robinhood.

Como os três endpoints diferem?

wss://jp.cryptolisting.ws (Tóquio) transmite o feed completo e é o endpoint global padrão. wss://kr.cryptolisting.ws (Seul) transmite Upbit e Bithumb e é otimizado para bots de trading colocalizados na Coreia — elimina o salto de rede Seul→Tóquio no lado da detecção. wss://us.cryptolisting.ws (N. Virginia) transmite apenas a Robinhood — eventos Robinhood Listing e Robinhood Live — para bots que operam na Robinhood. 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.