Лістинги криптовалют API оголошень

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

Огляд API

CryptoListing.ws надає два WebSocket-ендпоінти розсилки, які транслюють оголошення та повідомлення про лістинги від кількох криптобірж у реальному часі. API розроблено для автоматизованих торгових систем, яким потрібне якнайшвидше сповіщення про нові оголошення лістингів. Той самий API-ключ автентифікується на обох ендпоінтах — обирайте за розташуванням свого бота.

Формат повідомлення

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

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

Повний актуальний список значень listingType наведено в довіднику повідомлень.

Фільтрація за біржею

Використовуйте параметр запиту ?cex= на ендпоінті Tokyo, щоб підписатися лише на конкретні біржі. Ендпоінт Seoul і так транслює виключно оголошення Upbit, тож там фільтр не обов’язковий.

wss://cryptolisting.ws                       // Tokyo: усі біржі (Binance, Upbit, Bithumb)
wss://cryptolisting.ws?cex=binance             // Tokyo: лише binance
wss://cryptolisting.ws?cex=binance,upbit       // Tokyo: binance + upbit
wss://kr.cryptolisting.ws                    // Seoul: лише Upbit (надшвидко з Кореї)

Вимірювання затримки

Кожне оголошення містить дві позначки часу в мікросекундах від епохи 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.

Часті запитання

Який протокол використовує API?

WebSocket (RFC 6455) поверх TLS 1.2+. Автентифікація виконується через HTTP-заголовок X-API-Key у запиті на оновлення з’єднання. Повідомлення — це UTF-8 JSON у бінарних фреймах. Той самий API-ключ автентифікується на обох ендпоінтах — обирайте за розташуванням свого бота, а не за біржею, якою торгуєте.

Які біржі підтримуються?

Binance (спотові лістинги, ф’ючерсні лістинги, делістинги, HODLer-ейрдропи, додавання / зняття Monitoring Tag), Upbit і Bithumb (спотові лістинги на ринку KRW, зняття застережень і спотові делістинги — дієві для трейдингу стадії корейського циклу застережень). Нові біржі додаються за запитом підписників. Використовуйте параметр запиту ?cex= на ендпоінті Tokyo для фільтрації.

Як автентифікуватися?

Додайте заголовок X-API-Key до запиту на оновлення WebSocket-з’єднання. Отримайте свій ключ, звернувшись до нас у Telegram: @CLWfeed. Той самий ключ працює на обох ендпоінтах. Зразки коду див. у документації з автентифікації.

Яка затримка повідомлень?

Затримка розсилки надшвидка. Кожне оголошення несе поля detectedTimestampUs і dispatchTimestampUs з мікросекундною точністю, тож ви можете самостійно виміряти наскрізну продуктивність. Мережева затримка залежить від розташування вашого бота: хости в AWS Tokyo (ap-northeast-1a - apne1-az4) отримують найнижчу наскрізну затримку до ендпоінта Tokyo, а хости в AWS Seoul (ap-northeast-2c - apne2-az3) — до ендпоінта Upbit у Seoul.

Чим відрізняються два ендпоінти?

wss://cryptolisting.ws (Tokyo) транслює повний фід і є глобальним ендпоінтом за замовчуванням. wss://kr.cryptolisting.ws (Seoul) транслює лише Upbit і оптимізований для торгових ботів, розміщених у Кореї — він усуває мережевий стрибок Seoul→Tokyo на боці виявлення. Обмеження з’єднань і ліміти запитів відстежуються окремо для кожного ендпоінта.

Що станеться, якщо з’єднання розірветься?

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