Subscribe to a live feed of Polymarket transactions via Server-Sent Events (SSE). This endpoint establishes a long-lived HTTP connection that pushes each matched transaction to you as it occurs, including full market context, taker order details, and all matched maker orders.Documentation Index
Fetch the complete documentation index at: https://docs.polyedge.dev/llms.txt
Use this file to discover all available pages before exploring further.
SSE events are emitted with the event name
order. When parsing the stream, listen for event: order frames.Your PolyEdge API key.
Parameters
Comma-separated list of trader wallet addresses to filter by. Only transactions involving these traders will be emitted.
Comma-separated list of market tags to filter by (e.g.,
sports,crypto).Comma-separated list of series slugs to filter by (e.g.,
nba-2026,btc-up-or-down-5m).Minimum USDC value of the taker order.
Maximum USDC value of the taker order.
Minimum share amount of the taker order.
Maximum share amount of the taker order.
Minimum execution price (0–100 scale).
Maximum execution price (0–100 scale).
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 adata 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:
Market array (
| 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) |
[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]