# Introduction

Real-time WebSocket feed for crypto exchange listing announcements.\
Please contact [@cryptolistingws](https://t.me/cryptolistingws) on Telegram for websocket pricing information.

You can also subscribe to our Telegram Feed Channel [@cryptolistingwebsocket](https://t.me/cryptolistingwebsocket) to get constant relevant information.

Checkout our website for FAQ : [cryptolisting.ws](https://cryptolisting.ws).

### What is this?

This service delivers **instant notifications** when a cryptocurrency exchange publishes an announcement -- listings and other exchange announcements. You connect via WebSocket and receive structured JSON messages in real time.

**Currently supported exchanges:**

| Exchange           | Status |
| ------------------ | ------ |
| Binance            | Live   |
| Bithumb            | Live   |
| Upbit              | Live   |
| *More coming soon* | --     |

**Supported announcement types:**

| Type                | Description                                                          |
| ------------------- | -------------------------------------------------------------------- |
| `spot_listing`      | New spot market listing                                              |
| `futures_listing`   | New futures/perpetual listing                                        |
| `spot_delisting`    | Spot market delisting (coming soon)                                  |
| `futures_delisting` | Futures/perpetual delisting (coming soon)                            |
| `not_listing`       | Other exchange announcement (maintenance, airdrop, token swap, etc.) |

### How it works

```
Exchange publishes announcement
        |
        v
   Detection engine
        |
        v
   Dispatch server (< 1ms)
        |
        v
   Your WebSocket client
```

1. Our detection engine monitors exchange announcement pages continuously.
2. When a new listing is detected, it is parsed, classified, and forwarded to the dispatch server.
3. The dispatch server broadcasts the announcement to all connected WebSocket subscribers simultaneously.
4. You receive a JSON message with the ticker, exchange, listing type, and precise timestamps.

### Key features

* **Ultra-low latency** -- sub-millisecond dispatch from detection to your connection.
* **Precise timestamps** -- microsecond-resolution timestamps at every stage (publish, detect, dispatch) so you can measure your exact latency.
* **Exchange filtering** -- subscribe only to the exchanges you care about.
* **Always-on heartbeat** -- know immediately if your connection drops.
* **Zero-copy broadcast** -- announcements are serialized once and shared across all subscribers for maximum throughput.

### Quick links

| Topic                         | Description                       |
| ----------------------------- | --------------------------------- |
| Quick Start                   | Connect in under 5 minutes        |
| Authentication                | API key format and usage          |
| WebSocket API                 | Connection details and parameters |
| Message Reference             | Full JSON schema for all messages |
| Exchange Filtering            | Subscribe to specific exchanges   |
| Rate Limits & Security        | Limits, TLS, and security details |
| Error Handling & Reconnection | Close codes and retry strategy    |
| Code Examples                 | Python, Node.js, Go examples      |