Stream Orders

Subscribe to a real-time stream of Polymarket mempool order flow via Server-Sent Events (SSE). This low-latency feed allows you to see the market before it hits the chain. Powered by a multi-node synchronization engine, it streams live order flow up to 3-6 seconds faster than on-chain confirmation, offering 10ms transaction awareness and a >99.99% delivery rate. Features include fully resumable SSE connections to prevent data loss, rich payloads with deep market, user, and trade context, and advanced filtering options.

GET /v1/stream/orders

SSE events are emitted with the event name order. When parsing the stream, listen for event: order frames.

string

required

Your PolyEdge API key.

Parameters

string

Comma-separated list of trader wallet addresses to filter by. Only transactions involving these traders will be emitted.

string

Comma-separated list of market tags to filter by (e.g., sports,crypto).

string

Comma-separated list of series slugs to filter by (e.g., nba-2026,btc-up-or-down-5m).

float

Minimum USDC value of the taker order.

float

Maximum USDC value of the taker order.

float

Minimum share amount of the taker order.

float

Maximum share amount of the taker order.

float

Minimum execution price (0–100 scale).

float

Maximum execution price (0–100 scale).

string

Output format for each event payload. Set to json for a full JSON object. Defaults to a compact array format optimized for throughput.

Response

Each SSE event contains a data field with a single transaction payload. The shape depends on the format parameter.

Compact (default)
JSON (?format=json)

The default format emits each transaction as a compact JSON array. The array has four top-level elements:

Index	Description
`[0]`	`tx_hash` — the on-chain transaction hash
`[1]`	`timestamp` — transaction timestamp (UTC)
`[2]`	`market` — array of market fields (see below)
`[3]`	`taker_order` — array of taker order fields (see below)
`[4]`	`maker_orders` — array of maker order arrays (see below)

Market array ([2]):

[id, question, slug, start_date, end_date, icon, neg_risk, event_slug, series_slug, tags[], outcome_1, outcome_2, group_item_title, event_title, event_icon]

Taker/maker order array:

[side, [address, name, profile_image, x_username, profile_created_at], outcome, token_id, usdc, shares, fee, fee_rate_bps]

curl --no-buffer "https://api.polyedge.dev/v1/stream/orders?tags=sports" \
  -H "X-PolyEdge-Key: YOUR_API_KEY"

[
  "0xe1c7fd21906a0a4b664d9e71d883463d8e9cc0a9c644a9454d55617e0f627ab3",
  "2026-04-06 03:36:29Z",
  [
    1791549,
    "Rockets vs. Warriors",
    "nba-hou-gsw-2026-04-05",
    "2026-03-30 14:03:07Z",
    "2026-04-06 02:00:00Z",
    "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
    false,
    "nba-hou-gsw-2026-04-05",
    "nba-2026",
    [
      "sports",
      "basketball",
      "nba",
      "games"
    ],
    "Rockets",
    "Warriors",
    "",
    "Rockets vs. Warriors",
    "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png"
  ],
  [
    "SELL",
    [
      "0x96dd86f5cd9eb638defd1402ee5d2f9268f817fe",
      "bwho",
      "",
      "https://polymarket-upload.s3.us-east-2.amazonaws.com/profile-image-6694534-31362b0d-2c83-4504-ab01-f9e793143bb3.webp",
      "2026-03-14 05:29:19Z"
    ],
    "Warriors",
    "69471191026731922691690135719639615375023736950535506711537640368829468201458",
    "1362902000",
    "6408800000",
    "32191970",
    "1000"
  ],
  [
    [
      "SELL",
      [
        "0xe9cbb1c9b3f7f411dd4fdf2ea7afa780c8b4d096",
        "lameloballer",
        "",
        "",
        "2021-01-17 00:46:58Z"
      ],
      "Rockets",
      "32148469915004063556957721403141755650156885935319732065933001335332655819597",
      "334791600",
      "429220000",
      "0",
      "1000"
    ],
    [
      "BUY",
      [
        "0x68146921df11eab44296dc4e58025ca84741a9e7",
        "LynxTitan",
        "",
        "",
        "2025-12-12 05:09:42Z"
      ],
      "Warriors",
      "69471191026731922691690135719639615375023736950535506711537640368829468201458",
      "110000000",
      "500000000",
      "0",
      "1000"
    ],
    [
      "BUY",
      [
        "0x7edb8d9e184f9747d6957dc3d54e1e8a0d6e7993",
        "jmtest",
        "",
        "",
        "2025-12-13 10:59:50Z"
      ],
      "Warriors",
      "69471191026731922691690135719639615375023736950535506711537640368829468201458",
      "44000000",
      "200000000",
      "0",
      "1000"
    ],
    [
      "SELL",
      [
        "0xc4ef43a6c7b5b0b2d92a756fea9238c888281ce5",
        "",
        "",
        "",
        ""
      ],
      "Rockets",
      "32148469915004063556957721403141755650156885935319732065933001335332655819597",
      "449420400",
      "576180000",
      "0",
      "1000"
    ],
    [
      "BUY",
      [
        "0xde0463ea7f611b065e8ab06bbfbddad75e6dfa37",
        "mwenya",
        "",
        "",
        "2024-10-10 10:15:39Z"
      ],
      "Warriors",
      "69471191026731922691690135719639615375023736950535506711537640368829468201458",
      "420000000",
      "2000000000",
      "0",
      "1000"
    ],
    [
      "BUY",
      [
        "0xa31279ee3e489b094e5ea3b63162134a61675adf",
        "sideproject",
        "",
        "",
        "2025-12-15 22:41:10Z"
      ],
      "Warriors",
      "69471191026731922691690135719639615375023736950535506711537640368829468201458",
      "2100000",
      "10000000",
      "0",
      "1000"
    ],
    [
      "BUY",
      [
        "0x68146921df11eab44296dc4e58025ca84741a9e7",
        "LynxTitan",
        "",
        "",
        "2025-12-12 05:09:42Z"
      ],
      "Warriors",
      "69471191026731922691690135719639615375023736950535506711537640368829468201458",
      "105000000",
      "500000000",
      "0",
      "1000"
    ],
    [
      "BUY",
      [
        "0xd89609b183adc42b4c623a1b3ac45126031f9815",
        "gaoshangliushui",
        "",
        "",
        "2026-03-06 12:46:22Z"
      ],
      "Warriors",
      "69471191026731922691690135719639615375023736950535506711537640368829468201458",
      "10500000",
      "50000000",
      "0",
      "1000"
    ],
    [
      "BUY",
      [
        "0x68146921df11eab44296dc4e58025ca84741a9e7",
        "LynxTitan",
        "",
        "",
        "2025-12-12 05:09:42Z"
      ],
      "Warriors",
      "69471191026731922691690135719639615375023736950535506711537640368829468201458",
      "78750000",
      "375000000",
      "0",
      "1000"
    ],
    [
      "BUY",
      [
        "0x2d90f5a2e4a03e42a1186f759ff3e051e0aa1310",
        "Aceplus2",
        "",
        "",
        "2025-11-03 22:00:12Z"
      ],
      "Warriors",
      "69471191026731922691690135719639615375023736950535506711537640368829468201458",
      "371364000",
      "1768400000",
      "0",
      "1000"
    ]
  ]
]

Pass ?format=json to receive each event as a fully labeled JSON object.

curl --no-buffer "https://api.polyedge.dev/v1/stream/orders?format=json" \
  -H "X-PolyEdge-Key: YOUR_API_KEY"

{
  "tx_hash": "0x2aaacf76266d8b3bd59c469315e72f353836dadfb22be1660bb089057d4a44fd",
  "timestamp": "2026-04-06 03:36:32Z",
  "market": {
    "id": "1871234",
    "question": "Bitcoin Up or Down - April 5, 11:35PM-11:40PM ET",
    "slug": "btc-updown-5m-1775446500",
    "start_date": "2026-04-05 03:43:12Z",
    "end_date": "2026-04-06 03:40:00Z",
    "icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png",
    "neg_risk": false,
    "event_slug": "btc-updown-5m-1775446500",
    "series_slug": "btc-up-or-down-5m",
    "tags": [
      "crypto",
      "bitcoin",
      "crypto-prices",
      "recurring",
      "up-or-down",
      "hide-from-new",
      "5M"
    ],
    "outcome_1": "Up",
    "outcome_2": "Down",
    "group_item_title": "",
    "event_title": "Bitcoin Up or Down - April 5, 11:35PM-11:40PM ET",
    "event_icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png",
    "resolved_at": "",
    "winning_outcome": ""
  },
  "taker_order": {
    "side": "SELL",
    "usdc": "896700",
    "shares": "1470000",
    "trader": {
      "address": "0x58fcf1ebc9e29ca6746d3bef3116b171d8cd77ed",
      "name": "lkhagii765",
      "x_username": "",
      "profile_image": "",
      "profile_created_at": "2026-03-24 03:27:26Z"
    },
    "outcome": "Up",
    "fee": "25170",
    "token_id": "46645317725677844261247943895982148851563246385838622612003960053458514081961",
    "fee_rate_bps": "1000"
  },
  "maker_orders": [
    {
      "side": "BUY",
      "usdc": "896700",
      "shares": "1470000",
      "trader": {
        "address": "0x7cd2f2e87395e8be53a7a006caf09baad9603079",
        "name": "dotProduct66",
        "x_username": "",
        "profile_image": "",
        "profile_created_at": "2026-03-27 08:26:24Z"
      },
      "outcome": "Up",
      "fee": "0",
      "token_id": "46645317725677844261247943895982148851563246385838622612003960053458514081961",
      "fee_rate_bps": "1000"
    }
  ]
}

JSON response fields:

string

The on-chain transaction hash.

string

UTC timestamp of the transaction.

object

Full market details. Contains id, question, slug, start_date, end_date, icon, neg_risk, event_slug, series_slug, tags, outcome_1, outcome_2, group_item_title, event_title, event_icon, resolved_at, and winning_outcome.

object

The initiating taker order.

Show properties

string

BUY or SELL.

string

USDC value, in micro-USDC.

string

Share amount, in micro-units.

object

Trader profile: address, name, x_username, profile_image, profile_created_at.

string

The outcome being traded.

string

Fee paid, in micro-USDC.

string

ERC-1155 token ID of the outcome share.

string

Fee rate in basis points.

object[]

Array of maker orders matched in this transaction. Each object has the same structure as taker_order.

Analytics

Traders

Markets

Streaming

Parameters

Response

​Parameters

​Response

Parameters

Response