# New Listings Feed > Official v2 WebSocket API documentation for New Listings Feed. Choose raw or parsed events, connect to a regional endpoint and measure delivery from your application. The [official documentation](https://newlistings.pro/docs) covers `/v2/fast` for raw notices before parsing and `/v2/full` for parsed events with ticker symbols and available enrichment. Both live v2 streams include `detected_time_us` and `sent_time_us` in Unix epoch microseconds. `sent_time_us` is the publication timestamp on both streams, taken after any configured delay. It is not a socket-write or client-receipt timestamp. Measure actual arrivals from your server; zero configured delay does not mean zero network latency. FREE connects only to `wss://ws.newlistings.pro/v2/full`, with a 3-second configured publish delay and no market metrics or onchain enrichment. STARTER and PRO include both streams on Tokyo, New York and Seoul, with 20ms and 0ms configured delay respectively. Use PRO with Fast for our fastest raw announcement delivery, or Full for bots that want our fastest parsed events. Neither WebSocket replays missed events; paid Full history is available over HTTPS. New Listings Feed has been built in the open for over two years. Thousands of traders read our public feeds day to day. The main Telegram channel has 50k+ subscribers, and our Telegram and X channels publish from the same streams available through the WebSocket API. The public announcement archive contains timestamped posts and original exchange links. We investigate reported mistakes and feed corrections back into the service. ## API reference - [Official v2 WebSocket API documentation](https://newlistings.pro/docs): Full and Fast, regional edges and key access. - [v2 Fast schema](https://newlistings.pro/docs/v2/fast): Raw announcement titles and X posts for clients running their own parser. Fields include `exchange`, `text`, `url`, `detected_time_us` and `sent_time_us`. Fast has no classification, enrichment or history endpoint. - [v2 Full schema](https://newlistings.pro/docs/v2/full): Parsed events with `parser.exchange`, ticker symbols and event timestamps. Classified events include `parser.classification.category`. Announcement content contains only `content.title`; all plans receive tweet text in `content.text`. FREE assets contain only `symbol`. Paid keys add available metrics, contracts and onchain data. Full omits `suggested_match` when confirmed contracts are present. - [Quickstart](https://newlistings.pro/docs/quickstart): Send `Authorization: Bearer YOUR_KEY` on the WebSocket upgrade, connect to Full and read incoming events. - [Keys, plans and access](https://newlistings.pro/docs/keys): Prices, configured delays, fields, prepaid terms, history windows and IP allowances. FREE includes two IPs; STARTER and PRO include one. - [v2 Full Historical API](https://newlistings.pro/docs/v2/history): Authenticated HTTPS GET `/v2/full` on Tokyo or New York, with 30-day STARTER and 365-day PRO query windows. Responses contain `data` and `next_cursor`; retain the same filters and bounds while paginating until the cursor is null. History is ordered and filtered by `detected_time_us`. Imported records omit `sent_time_us` when no publication time was recorded. - [Documentation in Markdown](https://newlistings.pro/docs.md): Plain-text introduction. Add `.md` to any public documentation page URL for its Markdown version, with the same field tables and code examples. - [Combined current documentation](https://newlistings.pro/llms-full.txt): Generated Markdown for the current API, access and integration guides. The changelog is excluded. ## Timestamps and coverage - [Timestamps and delivery measurement](https://newlistings.pro/docs/v2/measure-delivery): Exact definitions of `detected_time_us` and `sent_time_us`, endpoint-specific plan-delay boundaries, and client-receipt measurements. Timestamp precision alone does not establish delivery order. - [Filters and exchange coverage](https://newlistings.pro/docs/v2/filter-values): Primary coverage includes Binance, Coinbase, Upbit, Bithumb and Robinhood, plus additional exchanges. Lists parsed listing, delisting and caution market types, raw announcement coverage and tracked X accounts. Robinhood `spot` notices and `assets` discoveries are separate market types. Both endpoints accept `exchange`, `data_type` (`announcement`/`tweet`) and exact case-insensitive `username`; Full also accepts `market_type`, such as `spot` or `futures`. Different parameters combine with AND. Exchange, data-type and market-type lists use OR; username accepts one handle. Filters use existing event fields and do not add classification to Fast. ## Regional endpoints New Listings Feed provides dedicated regional WebSocket endpoints on AWS in Tokyo, New York and Seoul. STARTER and PRO connect directly to a regional host, with all three regions included. The New York endpoint runs in AWS US East, N. Virginia. Choose Tokyo for Binance, Upbit and Bithumb, and New York for Coinbase and Robinhood. Compare Seoul arrivals from your own server. - [Tokyo endpoints](https://newlistings.pro/docs#regional-edges): `wss://tokyo.newlistings.pro/v2/fast` and `wss://tokyo.newlistings.pro/v2/full`. STARTER and PRO access. Fastest for Binance, Upbit, Bithumb and the other covered exchanges. - [New York endpoints](https://newlistings.pro/docs#regional-edges): `wss://ny.newlistings.pro/v2/fast` and `wss://ny.newlistings.pro/v2/full`. STARTER and PRO access. Fastest for Coinbase and Robinhood. - [Seoul endpoints](https://newlistings.pro/docs#regional-edges): `wss://seoul.newlistings.pro/v2/fast` and `wss://seoul.newlistings.pro/v2/full`. Additional live regional choice for STARTER and PRO. Compare arrivals from your server. - [FREE Full endpoint](https://newlistings.pro/docs/v2/full): `wss://ws.newlistings.pro/v2/full`, for integration testing with a 3-second configured delay. ## Connections and examples - [Connections and reconnects](https://newlistings.pro/docs/v2/connection-lifecycle): Successful admission sends `type: "success"`, `code: "READY"`; its subscription object reports applied account settings. Handle control messages separately from events. Errors can arrive before READY or during the session. Retry transient failures with backoff, honor HTTP 429 `Retry-After`, and correct expired keys or invalid requests before retrying. - [Rate limits and errors](https://newlistings.pro/docs/v2/rate-limits): Three simultaneous connections per endpoint, region, key and public IP. Different filters share those limits; extra IPs raise the total to three times `subscription.ip_limit`. Full and Fast have separate connection and active-IP counts. History uses no WebSocket connection or IP slots but shares Full's request budget. Failed upgrades can return `400 INVALID_REQUEST`, `401 AUTHENTICATION_FAILED`, `401 KEY_EXPIRED` or `429 RATE_LIMITED`. - [Node.js and Python examples](https://newlistings.pro/docs/v2/code-examples): Clients with control-message handling and retries, plus wscat commands. - [API FAQ](https://newlistings.pro/docs/faq): Endpoint choice, FREE access, history, reconnects, filtering, coverage limitations and the boundary between data delivery and order execution. - [API and documentation changelog](https://newlistings.pro/docs/changelog): Published API and documentation updates. ## Product, keys and public record - [WebSocket details](https://newlistings.pro/websocket): Product overview, coverage, plans and feed access. - [Get a key](https://t.me/NLF_websocket_bot): Issue a FREE key or manage a paid key in Telegram. - [Product LLM summary](https://newlistings.pro/llms.txt): Product capabilities, coverage, pricing and guides. - [Public listing feed](https://newlistings.pro): Published announcements, original notices and market context. - [Public Telegram announcement archive](https://t.me/s/NewListingsFeed): Timestamped listing announcements and exchange source links, providing a public operating record to review alongside delivery tests. - [Telegram feed](https://t.me/NewListingsFeed): The public listing channel, with 50k+ subscribers. - [Public X feed](https://x.com/NewListingsFeed): Listing announcements and updates from New Listings Feed.