WebSocket requires a Dev or Pro API key. Free tier keys cannot connect. Get your key →
{
"action": "subscribe",
"platform": "polymarket",
"version": 1,
"type": "orders",
"filters": {
"users": [
"0xe9cbb1c9b3f7f411dd4fdf2ea7afa780c8b4d096"
],
"status": "all"
}
}{
"action": "unsubscribe",
"subscription_id": "sub_2f4b15b33798"
}{
"action": "update",
"subscription_id": "sub_2f4b15b33798",
"filters": {
"users": [
"0xnew_address..."
],
"status": "all"
}
}{
"type": "ack",
"subscription_id": "sub_2f4b15b33798",
"channel": "trades"
}{
"event_type": "order_filled",
"status": "confirmed",
"user": "0xe9cbb1c9b3f7f411dd4fdf2ea7afa780c8b4d096",
"taker": "0x98f36c3d6300b905d00aef4bbae1d5a00874401f",
"side": "SELL",
"price": 0.04,
"shares": 2000000,
"shares_normalized": 2,
"fee": 0.008,
"token_id": "61192765571543...",
"token_label": "Up",
"outcome": "Up",
"outcome_index": 0,
"is_neg_risk": false,
"condition_id": "0x04f954e4f30f...",
"market_slug": "btc-updown-15m-1770244200",
"title": "Bitcoin Up or Down - February 4",
"order_hash": "0x8bf54f44e5d7...",
"tx_hash": "0xf30a29f249...",
"log_index": "0x21e",
"timestamp": 1770244731
}{
"event_type": "fee_refund",
"user": "0x47a51f21d742...",
"token_id": "53031995840519...",
"condition_id": "0xdfb2f9d3ed88...",
"market_slug": "btc-updown-15m-1770242400",
"title": "Bitcoin Up or Down",
"order_hash": "0xbda8ab86c90f...",
"tx_hash": "0x97b2ae331881...",
"refund": 9.9904,
"fee_charged": 0.0096
}{
"action": "subscribe",
"platform": "polymarket",
"version": 1,
"type": "orders",
"filters": {
"users": [
"0xe9cbb1c9b3f7f411dd4fdf2ea7afa780c8b4d096"
],
"status": "all"
}
}{
"action": "unsubscribe",
"subscription_id": "sub_2f4b15b33798"
}{
"action": "update",
"subscription_id": "sub_2f4b15b33798",
"filters": {
"users": [
"0xnew_address..."
],
"status": "all"
}
}{
"type": "ack",
"subscription_id": "sub_2f4b15b33798",
"channel": "trades"
}{
"event_type": "order_filled",
"status": "confirmed",
"user": "0xe9cbb1c9b3f7f411dd4fdf2ea7afa780c8b4d096",
"taker": "0x98f36c3d6300b905d00aef4bbae1d5a00874401f",
"side": "SELL",
"price": 0.04,
"shares": 2000000,
"shares_normalized": 2,
"fee": 0.008,
"token_id": "61192765571543...",
"token_label": "Up",
"outcome": "Up",
"outcome_index": 0,
"is_neg_risk": false,
"condition_id": "0x04f954e4f30f...",
"market_slug": "btc-updown-15m-1770244200",
"title": "Bitcoin Up or Down - February 4",
"order_hash": "0x8bf54f44e5d7...",
"tx_hash": "0xf30a29f249...",
"log_index": "0x21e",
"timestamp": 1770244731
}{
"event_type": "fee_refund",
"user": "0x47a51f21d742...",
"token_id": "53031995840519...",
"condition_id": "0xdfb2f9d3ed88...",
"market_slug": "btc-updown-15m-1770242400",
"title": "Bitcoin Up or Down",
"order_hash": "0xbda8ab86c90f...",
"tx_hash": "0x97b2ae331881...",
"refund": 9.9904,
"fee_charged": 0.0096
}Your Predexon API key
Subscribe to trade events. Use status filter for pending (mempool) events.
Remove a subscription by ID.
Replace filters on an existing subscription. Not supported on the orderbook channel.
Server acknowledgement for subscribe, unsubscribe, and update actions.
Trade fill event. status is 'pending' for mempool events or 'confirmed' for on-chain.
Maker fee rebate. Correlate to trades via order_hash.