Trades

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

Stream tick-level trade data for stock tickers via WebSocket. Each message delivers key trade details (price, size, exchange, conditions, and timestamps) as they occur, enabling users to track market activity, power live dashboards, and inform rapid decision-making.

Use Cases: Live monitoring, algorithmic trading, market analysis, data visualization.

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 (T)
The event type.
sym
string
The ticker symbol for the given stock.
x
integer
The exchange ID. See Exchanges for Polygon.io's mapping of exchange IDs.
i
string
The trade ID.
z
integer
The tape. (1 = NYSE, 2 = AMEX, 3 = Nasdaq).
p
number
The price.
s
integer
The trade size.
c
array (integer)
The trade conditions. See Conditions and Indicators for Polygon.io's trade conditions glossary.
t
integer
The SIP timestamp in Unix MS.
q
integer
The sequence number represents the sequence in which message events happened. These are increasing and unique per ticker symbol, but will not always be sequential (e.g., 1, 2, 6, 9, 10, 11).
trfi
integer
The ID for the Trade Reporting Facility where the trade took place.
trft
integer
The TRF (Trade Reporting Facility) Timestamp in Unix MS. This is the timestamp of when the trade reporting facility received this trade.
Code Examples
Subscription Request
WS
Log in or Sign up 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?