Messages
{
"assets_ids": [
"65818619657568813474341868652308942079804919287380422192892211131408793125422",
"52114319501245915516055106046884209969926127482827954674443846427813813222426"
],
"type": "market"
}{
"operation": "subscribe",
"assets_ids": [
"71321045679252212594626385532706912750332728571942532289631379312455583992563"
]
}{}{}{
"event_type": "book",
"asset_id": "65818619657568813474341868652308942079804919287380422192892211131408793125422",
"market": "0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af",
"bids": [
{
"price": "0.48",
"size": "30"
},
{
"price": "0.49",
"size": "20"
},
{
"price": "0.50",
"size": "15"
}
],
"asks": [
{
"price": "0.52",
"size": "25"
},
{
"price": "0.53",
"size": "60"
},
{
"price": "0.54",
"size": "10"
}
],
"timestamp": "1757908892351",
"hash": "0xabc123..."
}{
"event_type": "price_change",
"market": "0x5f65177b394277fd294cd75650044e32ba009a95022d88a0c1d565897d72f8f1",
"price_changes": [
{
"asset_id": "71321045679252212594626385532706912750332728571942532289631379312455583992563",
"price": "0.5",
"size": "200",
"side": "BUY",
"hash": "56621a121a47ed9333273e21c83b660cff37ae50",
"best_bid": "0.5",
"best_ask": "1"
}
],
"timestamp": "1757908892351"
}{
"event_type": "last_trade_price",
"asset_id": "114122071509644379678018727908709560226618148003371446110114509806601493071694",
"market": "0x6a67b9d828d53862160e470329ffea5246f338ecfffdf2cab45211ec578b0347",
"price": "0.456",
"size": "219.217767",
"fee_rate_bps": "0",
"side": "BUY",
"timestamp": "1750428146322",
"transaction_hash": "0xeeefffggghhh"
}{
"event_type": "tick_size_change",
"asset_id": "65818619657568813474341868652308942079804919287380422192892211131408793125422",
"market": "0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af",
"old_tick_size": "0.01",
"new_tick_size": "0.001",
"timestamp": "1757908892351"
}{
"event_type": "best_bid_ask",
"market": "0x0005c0d312de0be897668695bae9f32b624b4a1ae8b140c49f08447fcc74f442",
"asset_id": "85354956062430465315924116860125388538595433819574542752031640332592237464430",
"best_bid": "0.73",
"best_ask": "0.77",
"spread": "0.04",
"timestamp": "1766789469958"
}{
"event_type": "new_market",
"id": "1031769",
"question": "Will NVIDIA (NVDA) close above $240 end of January?",
"market": "0x311d0c4b6671ab54af4970c06fcf58662516f5168997bdda209ec3db5aa6b0c1",
"slug": "nvda-above-240-on-january-30-2026",
"description": "This market will resolve to \"Yes\" if the official closing price for NVIDIA (NVDA) on the final trading day of January 2026 is higher than the listed price. Otherwise, this market will resolve to \"No\".",
"assets_ids": [
"76043073756653678226373981964075571318267289248134717369284518995922789326425",
"31690934263385727664202099278545688007799199447969475608906331829650099442770"
],
"outcomes": [
"Yes",
"No"
],
"event_message": {
"id": "125819",
"ticker": "nvda-above-in-january-2026",
"slug": "nvda-above-in-january-2026",
"title": "Will NVIDIA (NVDA) close above ___ end of January?",
"description": "This market will resolve to \"Yes\" if the official closing price for NVIDIA (NVDA) on the final trading day of January 2026 is higher than the listed price. Otherwise, this market will resolve to \"No\"."
},
"timestamp": "1766790415550",
"tags": [
"stocks"
],
"condition_id": "0x311d0c4b6671ab54af4970c06fcf58662516f5168997bdda209ec3db5aa6b0c1",
"active": true,
"clob_token_ids": [
"76043073756653678226373981964075571318267289248134717369284518995922789326425",
"31690934263385727664202099278545688007799199447969475608906331829650099442770"
],
"sports_market_type": "",
"line": "",
"game_start_time": "",
"order_price_min_tick_size": "0.01",
"group_item_title": "NVDA above $240"
}{
"event_type": "market_resolved",
"id": "1031769",
"market": "0x311d0c4b6671ab54af4970c06fcf58662516f5168997bdda209ec3db5aa6b0c1",
"assets_ids": [
"76043073756653678226373981964075571318267289248134717369284518995922789326425",
"31690934263385727664202099278545688007799199447969475608906331829650099442770"
],
"winning_asset_id": "76043073756653678226373981964075571318267289248134717369284518995922789326425",
"winning_outcome": "Yes",
"timestamp": "1766790415550",
"tags": [
"stocks"
]
}Market Channel
Public WebSocket for real-time orderbook, price, and market lifecycle updates.
WSS
/
ws
/
market
Documentation Index
Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
Use this file to discover all available pages before exploring further.
Messages
{
"assets_ids": [
"65818619657568813474341868652308942079804919287380422192892211131408793125422",
"52114319501245915516055106046884209969926127482827954674443846427813813222426"
],
"type": "market"
}{
"operation": "subscribe",
"assets_ids": [
"71321045679252212594626385532706912750332728571942532289631379312455583992563"
]
}{}{}{
"event_type": "book",
"asset_id": "65818619657568813474341868652308942079804919287380422192892211131408793125422",
"market": "0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af",
"bids": [
{
"price": "0.48",
"size": "30"
},
{
"price": "0.49",
"size": "20"
},
{
"price": "0.50",
"size": "15"
}
],
"asks": [
{
"price": "0.52",
"size": "25"
},
{
"price": "0.53",
"size": "60"
},
{
"price": "0.54",
"size": "10"
}
],
"timestamp": "1757908892351",
"hash": "0xabc123..."
}{
"event_type": "price_change",
"market": "0x5f65177b394277fd294cd75650044e32ba009a95022d88a0c1d565897d72f8f1",
"price_changes": [
{
"asset_id": "71321045679252212594626385532706912750332728571942532289631379312455583992563",
"price": "0.5",
"size": "200",
"side": "BUY",
"hash": "56621a121a47ed9333273e21c83b660cff37ae50",
"best_bid": "0.5",
"best_ask": "1"
}
],
"timestamp": "1757908892351"
}{
"event_type": "last_trade_price",
"asset_id": "114122071509644379678018727908709560226618148003371446110114509806601493071694",
"market": "0x6a67b9d828d53862160e470329ffea5246f338ecfffdf2cab45211ec578b0347",
"price": "0.456",
"size": "219.217767",
"fee_rate_bps": "0",
"side": "BUY",
"timestamp": "1750428146322",
"transaction_hash": "0xeeefffggghhh"
}{
"event_type": "tick_size_change",
"asset_id": "65818619657568813474341868652308942079804919287380422192892211131408793125422",
"market": "0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af",
"old_tick_size": "0.01",
"new_tick_size": "0.001",
"timestamp": "1757908892351"
}{
"event_type": "best_bid_ask",
"market": "0x0005c0d312de0be897668695bae9f32b624b4a1ae8b140c49f08447fcc74f442",
"asset_id": "85354956062430465315924116860125388538595433819574542752031640332592237464430",
"best_bid": "0.73",
"best_ask": "0.77",
"spread": "0.04",
"timestamp": "1766789469958"
}{
"event_type": "new_market",
"id": "1031769",
"question": "Will NVIDIA (NVDA) close above $240 end of January?",
"market": "0x311d0c4b6671ab54af4970c06fcf58662516f5168997bdda209ec3db5aa6b0c1",
"slug": "nvda-above-240-on-january-30-2026",
"description": "This market will resolve to \"Yes\" if the official closing price for NVIDIA (NVDA) on the final trading day of January 2026 is higher than the listed price. Otherwise, this market will resolve to \"No\".",
"assets_ids": [
"76043073756653678226373981964075571318267289248134717369284518995922789326425",
"31690934263385727664202099278545688007799199447969475608906331829650099442770"
],
"outcomes": [
"Yes",
"No"
],
"event_message": {
"id": "125819",
"ticker": "nvda-above-in-january-2026",
"slug": "nvda-above-in-january-2026",
"title": "Will NVIDIA (NVDA) close above ___ end of January?",
"description": "This market will resolve to \"Yes\" if the official closing price for NVIDIA (NVDA) on the final trading day of January 2026 is higher than the listed price. Otherwise, this market will resolve to \"No\"."
},
"timestamp": "1766790415550",
"tags": [
"stocks"
],
"condition_id": "0x311d0c4b6671ab54af4970c06fcf58662516f5168997bdda209ec3db5aa6b0c1",
"active": true,
"clob_token_ids": [
"76043073756653678226373981964075571318267289248134717369284518995922789326425",
"31690934263385727664202099278545688007799199447969475608906331829650099442770"
],
"sports_market_type": "",
"line": "",
"game_start_time": "",
"order_price_min_tick_size": "0.01",
"group_item_title": "NVDA above $240"
}{
"event_type": "market_resolved",
"id": "1031769",
"market": "0x311d0c4b6671ab54af4970c06fcf58662516f5168997bdda209ec3db5aa6b0c1",
"assets_ids": [
"76043073756653678226373981964075571318267289248134717369284518995922789326425",
"31690934263385727664202099278545688007799199447969475608906331829650099442770"
],
"winning_asset_id": "76043073756653678226373981964075571318267289248134717369284518995922789326425",
"winning_outcome": "Yes",
"timestamp": "1766790415550",
"tags": [
"stocks"
]
}Subscription Request
type:object
Initial subscription message sent after connecting
Subscription Update
type:object
Subscribe or unsubscribe from assets without reconnecting
Ping
type:string
Client heartbeat — send every 10 seconds
Pong
type:string
Server heartbeat response
Orderbook Snapshot
type:object
Full aggregated orderbook for an asset
Price Change
type:object
Orderbook price level delta update
Last Trade Price
type:object
Trade execution event
Tick Size Change
type:object
Market tick size update event
Best Bid/Ask
type:object
Best bid and ask price update — requires custom_feature_enabled: true
New Market
type:object
New market creation event — requires custom_feature_enabled: true
Market Resolved
type:object
Market resolution event — requires custom_feature_enabled: true
Was this page helpful?
⌘I