> For the complete documentation index, see [llms.txt](https://nlf.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nlf.gitbook.io/docs/websocket.md).

# New Listings Feed WebSocket

{% hint style="info" %}
This page is a short overview. The full, current documentation is on our website: [newlistings.pro/docs](https://newlistings.pro/docs).
{% endhint %}

New Listings Feed sends crypto exchange announcements and X posts as JSON events over WebSocket, from regional edges in Tokyo, New York and Seoul. See live listings on [newlistings.pro](https://newlistings.pro/).

## Endpoints

| Endpoint   | What it sends                                         | Documentation                                |
| ---------- | ----------------------------------------------------- | -------------------------------------------- |
| `/v2/fast` | Raw announcement titles and X posts, faster than Full | [Fast](https://newlistings.pro/docs/v2/fast) |
| `/v2/full` | Parsed events with ticker symbols                     | [Full](https://newlistings.pro/docs/v2/full) |

STARTER and PRO keys connect to `tokyo.newlistings.pro`, `ny.newlistings.pro` and `seoul.newlistings.pro`. FREE keys connect to `ws.newlistings.pro/v2/full`. The [introduction](https://newlistings.pro/docs) tells which edge to choose.

## Keys

FREE, STARTER and PRO keys differ in endpoint access, delay and history. Compare them on [Keys](https://newlistings.pro/docs/keys). Get a key from [t.me/NLF\_websocket\_bot](https://t.me/NLF_websocket_bot).

## Get started

* [Quickstart](https://newlistings.pro/docs/quickstart): connect and read your first event.
* [Code examples](https://newlistings.pro/docs/v2/code-examples)
* [Historical API](https://newlistings.pro/docs/v2/history)
* [Product, plans and a free key](https://newlistings.pro/websocket)

The v1 API is retired. Use the v2 endpoints above.