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.

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
}

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

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 de adição aos ativos e de negociabilidade, 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://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 de adição aos ativos e de negociabilidade — 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.