Listados crypto API de anuncios

Una API WebSocket en tiempo real para anuncios y avisos de listado en bolsas crypto. Conéctate y recibe alertas JSON estructuradas de avisos de listado de Binance, Upbit y Bithumb.

Visión general de la API

CryptoListing.ws ofrece dos endpoints de despacho WebSocket que transmiten en streaming anuncios y avisos de listado en tiempo real de varias bolsas de criptomonedas. La API está diseñada para sistemas de trading automatizado que necesitan la notificación más rápida posible de nuevos anuncios de listado en bolsas. La misma clave de API autentica en ambos endpoints — elige según la ubicación de tu bot.

Formato de mensaje

Cada mensaje de anuncio contiene el ticker, la bolsa, el tipo de listado y tres marcas de tiempo con precisión de microsegundo:

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

Tipos de listado

Filtrado por bolsa

Usa el parámetro de consulta ?cex= en el endpoint de Tokio para suscribirte solo a bolsas concretas. El endpoint de Seúl ya transmite exclusivamente anuncios de Upbit, por lo que allí el filtro es opcional.

wss://cryptolisting.ws                       // Tokio: todas las bolsas (Binance, Upbit, Bithumb)
wss://cryptolisting.ws?cex=binance             // Tokio: solo binance
wss://cryptolisting.ws?cex=binance,upbit       // Tokio: binance + upbit
wss://kr.cryptolisting.ws                    // Seúl: solo Upbit (ultra-rápido desde Corea)

Medición de latencia

Cada anuncio incluye dos marcas de tiempo en microsegundos desde la época UNIX. Calcula tu latencia:

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

¿Por qué elegir esta API de anuncios de listado?

A diferencia de las API basadas en polling REST o de los bots de Telegram, nuestra API WebSocket entrega los avisos de listado en el instante en que se detectan. La retransmisión zero-copy significa que el mensaje de anuncio se serializa una sola vez y se comparte entre todos los suscriptores — sin la sobrecarga de serialización por cliente. Esta arquitectura logra una latencia de despacho ultra-rápida y constante, independientemente del número de suscriptores. Más información sobre bolsas concretas: avisos de listado de Binance, anuncios de listado de Upbit, avisos de listado de Bithumb.

Preguntas frecuentes

¿Qué protocolo usa la API?

WebSocket (RFC 6455) sobre TLS 1.2+. La autenticación se realiza mediante la cabecera HTTP X-API-Key en la petición de upgrade. Los mensajes son JSON UTF-8 en frames binarios. La misma clave de API autentica en ambos endpoints — elige según la ubicación de tu bot, no según la bolsa que operas.

¿Qué bolsas están soportadas?

Binance (listados spot, listados de futuros, deslistados, HODLer airdrops, Monitoring Tag extend / remove), Upbit y Bithumb (listados spot del mercado KRW, liberaciones de aviso y deslistados spot — las etapas accionables del ciclo de aviso coreano). Se añaden más bolsas según la demanda de los suscriptores. Usa el parámetro de consulta ?cex= en el endpoint de Tokio para filtrar.

¿Cómo me autentico?

Incluye la cabecera X-API-Key en la petición de upgrade de WebSocket. Obtén tu clave contactándonos en Telegram en @CLWfeed. La misma clave funciona en ambos endpoints. Consulta la documentación de autenticación para ver ejemplos de código.

¿Cuál es la latencia de los mensajes?

La latencia de despacho es ultra-rápida. Cada anuncio lleva los campos detectedTimestampUs y dispatchTimestampUs con precisión de microsegundo para que puedas medir de forma independiente el rendimiento de extremo a extremo. La latencia de red depende de la ubicación de tu bot: los hosts en AWS Tokio (ap-northeast-1a - apne1-az4) obtienen la menor latencia de extremo a extremo hacia el endpoint de Tokio, y los hosts en AWS Seúl (ap-northeast-2c - apne2-az3) hacia el endpoint de Upbit en Seúl.

¿En qué se diferencian los dos endpoints?

wss://cryptolisting.ws (Tokio) transmite el feed completo y es el endpoint global por defecto. wss://kr.cryptolisting.ws (Seúl) transmite solo Upbit y está optimizado para bots de trading colocalizados en Corea — elimina el salto de red Seúl→Tokio en el lado de la detección. Los límites de conexión y de tasa se controlan de forma independiente por endpoint.

¿Qué ocurre si se cae la conexión?

El servidor envía un heartbeat cada 30 segundos; los clientes deberían enviar pings de WebSocket con la misma cadencia. Al desconectarse, reconéctate con backoff exponencial (normalmente empezando en 1s y duplicando hasta 30s). Los listados emitidos mientras estabas desconectado NO se reenvían — para un registro auditable de detecciones pasadas, consulta las últimas detecciones.