Activity Events

The activity channel ("activity") delivers four event types: split, merge, redeem, and conversion. These represent position management operations on Polymarket’s Conditional Token Framework.

pUSD deposit/withdrawal events are on a separate collateral channel - not mixed into activity. Subscribe to both if you need full wallet flow.

condition_id is null only for the conversion event type (NegRisk conversions span multiple conditions). Clients with strict typed generators (condition_id: string) should widen to string | null if they want to consume conversion events. If you filter by event_type in {"split", "merge", "redeem"}, no change is needed.

split

A user deposits collateral (USDC) to mint outcome tokens for a market.

{
  "type": "event",
  "subscription_id": "sub_2f4b15b33798",
  "data": {
    "event_type": "split",
    "user": "0x6d38b759c90c3158fa7b4fa45b0145eefd58d910",
    "condition_id": "0x7fc83e5029c8e7b752f2fda61158f6cbc185c0a7b60d34d56231fcc09c62ce44",
    "collateral_token": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
    "amount": 100000000,
    "amount_normalized": 100,
    "payout": null,
    "payout_normalized": null,
    "tx_hash": "0x0708391d4276731737d14a388491afb8a9c2f5b133f597189993b3ebf9154c37",
    "log_index": "0x355",
    "block_number": "0x4ebcd4d",
    "timestamp": 1770244769,
    "title": "Bitcoin Up or Down - February 4, 5:45PM-6:00PM ET",
    "market_slug": "btc-updown-15m-1770245100",
    "market_id": "1329555",
    "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png",
    "tokens": [
      { "token_id": "3461486922...", "label": "Up" },
      { "token_id": "9291673453...", "label": "Down" }
    ]
  }
}

merge

A user returns a full set of outcome tokens to redeem collateral (USDC) before market resolution.

{
  "type": "event",
  "subscription_id": "sub_2f4b15b33798",
  "data": {
    "event_type": "merge",
    "user": "0xe8dd7741ccb12350957ec71e9ee332e0d1e6ec86",
    "condition_id": "0x4dab1a074a9dbfc122f49b1b4e683d0b9960738107623d2dfd974eb98865a020",
    "collateral_token": null,
    "amount": 40980000,
    "amount_normalized": 40.98,
    "payout": null,
    "payout_normalized": null,
    "tx_hash": "0xd198bdd0226e5225a103aaaa01cf38aac4bc34891dd8ba31832f454cb7d65da1",
    "log_index": "0x54f",
    "block_number": "0x4ebcd51",
    "timestamp": 1770244777,
    "title": "Will \"NUEVAYOL\" be played first at the Super Bowl halftime show?",
    "market_slug": "will-nuevayol-be-played-first-at-the-super-bowl-halftime-show",
    "market_id": "811834",
    "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/...",
    "tokens": [
      { "token_id": "8405376573...", "label": "Yes" },
      { "token_id": "3675765791...", "label": "No" }
    ]
  }
}

redeem

A user redeems winning outcome tokens for collateral (USDC) after a market has resolved.

{
  "type": "event",
  "subscription_id": "sub_2f4b15b33798",
  "data": {
    "event_type": "redeem",
    "user": "0x1f4c2a421a36e5da4e013c557dc29fdec7cb2e01",
    "condition_id": "0x6b6de56b0057be1b236ef4e52745ca1160497419789ffe3c6f0f95b12e195762",
    "collateral_token": null,
    "amount": 0,
    "amount_normalized": 0,
    "payout": 20000000,
    "payout_normalized": 20,
    "tx_hash": "0x8fbd25676f0b4d0a2af786716f406100f24492b1246bb16b580cb7a5aefd0931",
    "log_index": "0x26d",
    "block_number": "0x4ebcd4a",
    "timestamp": 1770244763,
    "title": "Will Sunderland AFC win on 2026-02-02?",
    "market_slug": "epl-sun-bur-2026-02-02-sun",
    "market_id": "1225150",
    "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/...",
    "tokens": [
      { "token_id": "3331904137...", "label": "Yes" },
      { "token_id": "9751235886...", "label": "No" }
    ]
  }
}

conversion

A user converts “No” positions in a NegRisk event back to collateral. NegRisk conversions span multiple conditions, so condition_id is null - use neg_risk_event_id + index_set instead.

{
  "type": "event",
  "subscription_id": "sub_2f4b15b33798",
  "data": {
    "event_type": "conversion",
    "user": "0xbc5403011df159368c4bc716e07bcf858dfe2eec",
    "condition_id": null,
    "amount": 13074500,
    "amount_normalized": 13.0745,
    "tx_hash": "0xabc...",
    "log_index": "0x548",
    "block_number": "0x51e0002",
    "timestamp": 1776824366,
    "version": 2,
    "neg_risk_event_id": "0x6375f96fe3910d68...",
    "index_set": "320"
  }
}

neg_risk_event_id: the NegRiskAdapter’s marketId identifying a cluster of related binary questions (distinct from Polymarket’s numeric market_id).
index_set: bitmap of which question indices within that event were converted. Decimal string of a uint256. Interpret by bit position: indexSet & (1 << i) → question i was included. Example "320" = bits 6 & 8 set.
Routes on activity.user.* and activity.wildcard only (no activity.condition.* route since there’s no single condition).

Field Reference

Field	Type	Description
`event_type`	`"split"` \| `"merge"` \| `"redeem"` \| `"conversion"`
`user`	string	User address
`condition_id`	string \| null	Market condition ID. `null` only for `conversion` events.
`neg_risk_event_id`	string \| null	NegRiskAdapter marketId (present on `conversion` only)
`index_set`	string \| null	uint256 bitmap as decimal string (present on `conversion` only)
`collateral_token`	string \| null	Collateral token contract address (USDC)
`amount`	number	Collateral amount (raw, 6 decimal places)
`amount_normalized`	number	Human-readable collateral amount
`payout`	number \| null	Payout amount in raw units (redeem only)
`payout_normalized`	number \| null	Human-readable payout (redeem only)
`tokens`	array \| null	Outcome tokens for this market
`title`	string \| null	Market title
`market_slug`	string \| null	Market URL slug
`market_id`	string \| null	Internal market ID
`image`	string \| null	Market image URL
`tx_hash`	string	Transaction hash
`log_index`	string	Log index (hex)
`block_number`	string	Block number (hex)
`timestamp`	number	Unix timestamp in seconds
`version`	number \| null	`1` for V1 contracts, `2` for V2 contracts (currently always `1`)

Example: Tracking Redemptions

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);

  if (msg.type === 'event') {
    const data = msg.data;

    if (data.event_type === 'redeem') {
      console.log(`Redemption: $${data.payout_normalized}`);
      console.log(`Market: ${data.title}`);
      console.log(`Wallet: ${data.user}`);
    }
  }
};

Getting Started

Ticks

Markets

Discovery & Taxonomy

Pricing & Candles

Orderbooks

Trades

Activity & Positions

Wallet Identity

Wallet Positions & P&L

Smart Money & Leaderboards

Oracle & Settlement

Builders

Real-Time Signals (WebSocket)

Backtesting

Reference

split

merge

redeem

conversion

Field Reference

Example: Tracking Redemptions

​split

​merge

​redeem

​conversion

​Field Reference

​Example: Tracking Redemptions

split

merge

redeem

conversion

Field Reference

Example: Tracking Redemptions