Imbalances

WS
Real-Time: wss://socket.polygon.io/stocks

Stream real-time Net Order Imbalance (NOI) events for specified stock tickers via WebSocket. Each event highlights buy and sell pressure around scheduled exchange auctions, including details such as imbalance quantity, paired quantity, and indicative clearing price. These updates provide transparency into auction dynamics, helping users understand supply and demand conditions during critical market events.

Use Cases: Auction price discovery, execution timing, liquidity monitoring, short-term trading signals, market event analysis.

Plan
Recency
Not included
Not included
Not included
Not included
Not included
Plan RecencyReal-time
Plan HistoryNot applicable
Parameters
ticker
string
required
Specify a stock ticker or use * to subscribe to all stock tickers. You can also use a comma separated list to subscribe to multiple stock tickers. You can retrieve available stock tickers from our Stock Tickers API.
Response Attributes
ev
enum (NOI)
The event type.
T
string
The ticker symbol for the given stock.
t
integer
The Timestamp in Unix MS.
at
integer
The time that the auction is planned to take place in the format (hour x 100) + minutes in Eastern Standard Time, for example 930 would be 9:30 am EST, and 1600 would be 4:00 pm EST.
a
string
The auction type. `O` - Early Opening Auction (non-NYSE only) `M` - Core Opening Auction `H` - Reopening Auction (Halt Resume) `C` - Closing Auction `P` - Extreme Closing Imbalance (NYSE only) `R` - Regulatory Closing Imbalance (NYSE only)
i
integer
The symbol sequence.
x
integer
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
o
integer
The imbalance quantity.
p
integer
The paired quantity.
b
number
The book clearing price.
Code Examples
Subscription Request
WS
Sign in or Create account to Polygon to customize the websocket code examples. It's free.
Response Object
Did you find this page helpful?
Do you still need help with something?