API объявлений о листингах

WebSocket API объявлений и уведомлений о листингах на криптобиржах в реальном времени. Подключитесь и получайте структурированные JSON-оповещения о листингах Binance, Upbit, Bithumb и Robinhood.

Обзор API

CryptoListing.ws предоставляет три WebSocket-эндпоинта рассылки, которые стримят объявления и уведомления о листингах с нескольких криптобирж в реальном времени. API создан для автоматических торговых систем, которым нужно максимально быстрое уведомление о новых объявлениях о листингах. Один и тот же API-ключ аутентифицирует на всех трёх эндпоинтах — выбирайте по местоположению вашего бота.

Кому подходит этот API

• Торговым ботам и квант-командам, которые реагируют на листинги, делистинги и предупреждения и которым нужен машиночитаемый триггер.
• Разработчикам сервисов уведомлений и дашбордов, покрывающих Binance, Upbit, Bithumb и Robinhood без отдельной интеграции для каждой биржи.
• Исследователям, которым нужна история объявлений с метками времени: бесплатный JSON-фид и архив последних листингов, где у каждого объявления своя страница с графиком реакции цены.
• Не пишете бота? Скорее всего, вам нужны просто уведомления: подпишитесь на бесплатный Telegram-канал или на @cryptolistingws в X (EN).

Бесплатные варианты

• SpeedTrial — бесплатный WebSocket-ключ к боевому фиду с вежливой задержкой +1 мс; тикер и заголовок скрыты. Для бенчмарков. Ключ на неделю, продлевается по запросу.
• FreeDelayed — бесплатный WebSocket-ключ с полным фидом, включая тикер и заголовок, и задержкой +240 мс. Ключ на неделю, продлевается по запросу.
• Публичный JSON-фид — последние объявления в статическом файле, без ключа. Это не поток в реальном времени.
• Telegram-канал и аккаунт в X — бесплатные уведомления для чтения.

Платные тарифы — Basic (+20 мс) и Premium (без задержки) — оплачиваются за каждую биржу помесячно в USDT: см. тарифы и калькулятор цены. Любой ключ, бесплатный или платный, выдаётся по запросу в Telegram — самостоятельной регистрации нет.

Официальные API объявлений бирж и этот API

Binance и Upbit уже публикуют собственные потоки объявлений, а Bithumb отдаёт свои объявления через REST. Они ничего не стоят, кроме аккаунта на бирже (Bithumb не требует и его), и хорошо подходят, если вы торгуете на одной бирже и готовы сами разбирать заголовки. По документации на 28 сентября 2026 г.:

Берите официальный канал, если торгуете на одной бирже и можете сами поддерживать разбор. Берите этот API, если нужны несколько бирж в одном соединении, стабильная схема с уже извлечёнными тикером и типом события, классифицированные делистинги и снятия предупреждений, а также события Robinhood. Сравнений скорости с официальными каналами мы не публикуем.

Источники (проверены 28 сентября 2026 г.) — Публичные страницы, на которых основан каждый факт о другом сервисе (адреса без ссылок):

• Binance — https://developers.binance.com/docs/cms/general-info · https://developers.binance.com/docs/cms/announcement
• Upbit — https://docs.upbit.com/kr/reference/websocket-announcement · https://docs.upbit.com/kr/changelog/websocket-announcement
• Bithumb — https://apidocs.bithumb.com/reference/%EA%B3%B5%EC%A7%80%EC%82%AC%ED%95%AD-%EC%A1%B0%ED%9A%8C

Формат сообщения

Каждое сообщение об объявлении содержит тикер, биржу, тип листинга и две метки времени с микросекундной точностью:

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

Полный актуальный список значений listingType приведён в справочнике сообщений.

Фильтрация по биржам

Используйте query-параметр ?cex= на токийском эндпоинте, чтобы подписаться только на конкретные биржи. Сеульский эндпоинт стримит Upbit и Bithumb, поэтому тот же фильтр работает и там. Robinhood отдаётся только американским эндпоинтом wss://us.cryptolisting.ws, который не передаёт никакие другие биржи.

wss://jp.cryptolisting.ws                    // Токио: Binance, Upbit, Bithumb — Robinhood на wss://us.cryptolisting.ws
wss://jp.cryptolisting.ws?cex=binance        // Токио: только binance
wss://jp.cryptolisting.ws?cex=binance,upbit  // Токио: binance + upbit
wss://kr.cryptolisting.ws                    // Сеул: Upbit + Bithumb (ультра-быстро из Кореи)

Измерение задержки

Каждое объявление содержит две отметки времени в микросекундах от эпохи UNIX. Вычислите свою задержку:

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

Почему стоит выбрать этот API объявлений о листингах?

В отличие от REST-API с опросом или Telegram-ботов, наш WebSocket API доставляет уведомления о листингах в тот же миг, как они обнаружены. Zero-copy рассылка означает, что сообщение об объявлении сериализуется один раз и передаётся всем подписчикам — без накладных расходов на сериализацию для каждого клиента. Такая архитектура обеспечивает стабильно ультра-быструю задержку рассылки независимо от числа подписчиков. Подробнее по отдельным биржам: уведомления о листингах Binance, объявления о листингах Upbit, уведомления о листингах Bithumb.

Пишете бота? Воспользуйтесь пошаговым руководством по снайпер-боту для листингов Binance на Python (EN). Есть и руководство по боту для листингов Upbit и Bithumb на Python (EN). Полный справочник API описывает WebSocket API (EN), схему сообщений (EN) и примеры кода на Python, Node.js, Go и Rust (EN).

Частые вопросы

Какой протокол использует API?

WebSocket (RFC 6455) поверх TLS 1.2+. Аутентификация выполняется через HTTP-заголовок X-API-Key в запросе апгрейда. Сообщения — UTF-8 JSON в бинарных фреймах. Один и тот же API-ключ аутентифицирует на всех трёх эндпоинтах — выбирайте по местоположению бота, а не по бирже, на которой торгуете.

Какие биржи поддерживаются?

Binance (спот-листинги, фьючерсные листинги, делистинги, HODLer-эйрдропы, Monitoring Tag extend / remove), Upbit и Bithumb (спот-листинги на рынке KRW, снятие caution и спот-делистинги — торгуемые стадии корейского лайфцикла caution) и Robinhood (события Robinhood Listing и Robinhood Live, отдаются с wss://us.cryptolisting.ws). Новые биржи добавляются по запросам подписчиков. Используйте query-параметр ?cex= на токийском эндпоинте для фильтрации.

Как пройти аутентификацию?

Добавьте заголовок X-API-Key в запрос апгрейда WebSocket. Получите ключ, написав нам в Telegram на @CLWfeed. Один и тот же ключ работает на всех трёх эндпоинтах. Примеры кода — в документации по аутентификации.

Какая задержка сообщений?

Задержка рассылки ультра-быстрая. Каждое объявление несёт поля detectedTimestampUs и dispatchTimestampUs с микросекундной точностью, чтобы вы могли самостоятельно измерить производительность от начала до конца. Сетевая задержка зависит от местоположения бота: хосты в AWS Tokyo (ap-northeast-1a - apne1-az4) получают наименьший end-to-end до токийского эндпоинта, хосты в AWS Seoul (ap-northeast-2c - apne2-az3) — до сеульского эндпоинта, который стримит Upbit и Bithumb, а хосты в AWS N. Virginia (us-east-1a - use1-az1) — до US-эндпоинта, который стримит Robinhood.

Чем различаются три эндпоинта?

wss://jp.cryptolisting.ws (Токио) стримит полный фид и является глобальным эндпоинтом по умолчанию. wss://kr.cryptolisting.ws (Сеул) стримит Upbit и Bithumb и оптимизирован для торговых ботов, размещённых в Корее — он устраняет сетевой переход Сеул → Токио на стороне обнаружения. wss://us.cryptolisting.ws (Сев. Вирджиния) стримит только Robinhood — события Robinhood Listing и Robinhood Live — для ботов, торгующих на Robinhood. Лимиты подключений и запросов учитываются независимо на каждом эндпоинте.

Что происходит при разрыве соединения?

Сервер отправляет heartbeat каждые 30 секунд; клиентам следует отправлять WebSocket-пинги с той же частотой. При разрыве переподключайтесь с экспоненциальной задержкой (обычно начиная с 1 с, удваивая до 30 с). Листинги, отправленные, пока вы были отключены, НЕ воспроизводятся повторно — для журнала прошлых обнаружений см. последние обнаружения.