Room ID: polymarket_market_metrics
Endpoint: wss://api.struct.to/ws
Rate: 0.025 credits per message
Subscribe
The condition_ids filter is required. You may optionally specify timeframes to limit which windows you receive. A maximum of 100 filters is allowed per client.
Filters
| Filter | Type | Required | Description |
|---|
condition_ids | string[] | Yes | Markets to track by condition ID |
timeframes | string[] | No | Timeframe windows to receive updates for |
Example
{
"type": "join_room",
"payload": {
"room_id": "polymarket_market_metrics"
}
}
{
"type": "room_message",
"payload": {
"room_id": "polymarket_market_metrics",
"message": {
"action": "subscribe",
"condition_ids": ["0xabc123..."]
}
}
}
Response
{
"type": "market_metrics_stream_subscribe_response",
"room_id": "polymarket_market_metrics",
"data": {
"condition_ids": ["0xabc123..."],
"timeframes": [],
"rejected": []
}
}
Events
market_metrics_update
Volume on Polymarket vs. Struct. Polymarket’s UI reports “volume” as notional (the count of shares or contracts traded), which corresponds to shares_volume in Struct payloads. usd_volume is the dollar value of those trades. Use shares_volume to match figures shown on Polymarket and usd_volume for true USD throughput.
{
"type": "market_metrics_update",
"room_id": "polymarket_market_metrics",
"data": {
"condition_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"timeframe": "1h",
"timestamp": 1743500000,
"usd_volume": "125000.50",
"shares_volume": "192300.00",
"builder_usd_volume": "31200.00",
"builder_shares_volume": "48000.00",
"fees": 250.0,
"builder_fees": 62.5,
"txns": 340,
"builder_txns": 85,
"unique_traders": 85,
"unique_builder_traders": 22
}
}
