Skip to content
New Listings Feed
Getting startedIntroduction

WebSocket API

WebSocket endpoints, event formats, regional hosts and key access.

New Listings Feed delivers exchange announcements and X posts as JSON events. Use /v2/fast for raw notices or /v2/full for parsed events with ticker symbols and available asset data.

Both live streams include detected_time_us and sent_time_us in Unix epoch microseconds. See Timestamps and delivery measurement for their meaning and how to measure arrivals from your server.

Endpoints

Feature Full Fast
Content Parsed events Raw announcement titles and X posts
Asset data Ticker symbols; STARTER and PRO add available metrics and onchain data None
Speed Includes parsing time Typically 0.5–2 ms faster than Full
History Historical API for STARTER and PRO None

Regional edges

New Listings Feed provides dedicated regional WebSocket endpoints on AWS in Tokyo, New York and Seoul. STARTER and PRO keys connect directly to the chosen host, with all three regions included. Choose the endpoint for the exchanges your bot follows, then compare arrival times from your server.

Edge AWS region Availability zone WebSocket host Region choice
Tokyo Tokyo ap-northeast-1a tokyo.newlistings.pro Fastest for Binance, Upbit, Bithumb and the other covered exchanges
New York US East, N. Virginia us-east-1b ny.newlistings.pro Fastest for Coinbase and Robinhood
Seoul Seoul ap-northeast-2a seoul.newlistings.pro Additional regional edge; compare arrivals from your server

Append /v2/fast for raw announcements or /v2/full for parsed events. For example, a Binance or Upbit bot can connect to wss://tokyo.newlistings.pro/v2/fast, while a Coinbase or Robinhood bot can use wss://ny.newlistings.pro/v2/full. Both streams are available on every regional host. See Full and Fast for their schemas and filters.

FREE keys connect to wss://ws.newlistings.pro/v2/full.

Keys

Key Endpoint access Added delay
FREE Full (limited) 3s
STARTER Full and Fast 20ms
PRO Full and Fast 0ms