Home /

Polymarket WebSocket reference

Choose a feed and check connection requirements and key fields.

Full API documentation ↗

Polymarket mempoolmmp.trade-batch.v1

Polygon mempoolpolygon.pending.v1

01

API key → Ticket → WSS

API keys request connection tickets. A ticket is typically single-use within 60 seconds; this deadline does not end an established healthy connection. Use the response values.

02

Read normalized fills correctly

fill_index 0 is the taker; subsequent entries are makers. Taker match_type is null; other allowed values include COMPLEMENTARY, MINT and MERGE. Deduplicate by (tx_hash, fill_index).

03

Data limits

A failed fill validation may drop the entire batch. Pending transactions can be replaced, reverted or dropped, without later confirmation events or historical replay. Raw data does not guarantee network-wide coverage.

Field excerpt · not a complete frame
{
  "tx_hash": "0x…",
  "fills": [
    {
      "fill_index": 0,
      "order_role": "taker",
      "match_type": null,
      "maker": "0x…",
      "side": "BUY",
      "price": "0.54",
      "size": "25"
    }
  ]
}

The standard feed has no source timestamp. End-to-end latency measurement requires an independent, aligned timing source.

Check the fields with real data

Start on Free. No paid subscription required.

Start free