Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

Real-time WebSocket feed for crypto exchange listing announcements. Connect over WSS, receive structured JSON the moment a listing, delisting, or risk event is detected.

No key yet? Binance, Upbit and Bithumb listings, delistings and risk events, and Robinhood events, are also published as a free JSON file and Atom feeds, readable without an API key — see Public JSON & Atom Feeds.

For LLMs, full documentation in a single txt file here.

Supported exchanges

ExchangeStatus
BinanceLive
UpbitLive
BithumbLive
RobinhoodLive

Announcement types

TypeDescriptionExchangesImpact
spot_listingNew spot market listingBinance, Upbit, Bithumb+
spot_delistingSpot market delistingBinance, Upbit, Bithumb−
futures_listingNew futures / perpetual listingBinance+
futures_delistingFutures / perpetual delistingBinance−
hodler_airdropBinance HODLer AirdropBinance+
monitoring_tag_extendToken added to Binance’s Monitoring TagBinance−
monitoring_tag_removeToken removed from Binance’s Monitoring TagBinance+
caution_releasedCaution designation liftedBithumb, Upbit+
wallet_listingRobinhood Listing: added to Robinhood, not tradable yet on Robinhood (not a promise that trading will open on Robinhood)Robinhood+
cex_listingRobinhood Live: tradable on RobinhoodRobinhood+
not_listingOther announcement (maintenance, token swap, etc.)Binancen/a

See Message Reference for full payload schemas.

Features

  • Microsecond timestamps at every stage (detect, dispatch).
  • Pre-parsed ticker and listingType on every message; original title kept for cross-checking.
  • Upbit spot listings name the quote markets they open (markets), and group several tokens into one event.
  • Per-exchange filtering via ?cex=.
  • WebSocket PING every 15 s; libraries handle PONG automatically.

Next steps

PagePurpose
Quick StartConnect in under 5 minutes
AuthenticationAPI key format and usage
WebSocket APIEndpoints, lifecycle, query parameters
Message ReferenceJSON schemas for every message type
Exchange Filtering?cex= and event-type filtering
Rate LimitsConnection, message, and per-key caps
Error HandlingClose codes and reconnection strategy
Code ExamplesPython, Node.js, Go, Rust
Public JSON & Atom FeedsFree feeds, no API key: JSON file and Atom