Skip to main content
Trades WebSocket
curl --request GET \
  --url https://synthesis.trade/api/v1/trades/ws \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "venue": "<string>",
  "markets": [
    "0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910",
    "KXBTC-25-T100000"
  ],
  "offset": 100
}
'

Body

application/json
​
type
string
required

WebSocket message type. Supported values: subscribe or unsubscribe.

​
venue
string

Optional venue filter. Supported values: polymarket or kalshi. If omitted, the all-venues stream is only supported when markets is also omitted.

​
markets
string[]

Optional list of market IDs. Maximum 1000 items. For Polymarket, use condition IDs. For Kalshi, use market IDs. Mixed-venue lists are supported when you provide the matching IDs for each venue.

Example:
[
  "0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910",
  "KXBTC-25-T100000"
]
​
offset
integer
default:0

Historical pagination offset. Historical queries return 100 trades per venue/query shape. Live subscription is only attached when offset is 0 or omitted.

Example:

100

Response

101

WebSocket connection established