Market Lifecycle

This page covers subscribing to market creation and resolution events with subscribe_market_lifecycle, and the marketCreated and marketResolved payloads that subscription delivers.

Subscribing to market lifecycle events

Subscribe to market creation and resolution events by emitting subscribe_market_lifecycle. No authentication required.

socket.on('connect', () => {
  socket.emit('subscribe_market_lifecycle');
});

socket.on('marketCreated', (data) => {
  console.log('New market:', data.slug, data.title);
});

socket.on('marketResolved', (data) => {
  console.log('Market resolved:', data.slug, data.winningOutcome);
});

marketResolved is also emitted to existing per-market room subscribers automatically (CLOB: market:{slug}, AMM: market:{address}). You don’t need a separate lifecycle subscription to receive resolution events for markets you’re already watching.

To unsubscribe:

socket.emit('unsubscribe_market_lifecycle');

Event payloads

`marketCreated`

Emitted when a new market is funded and visible. Hidden markets are excluded.

{
  "slug": "btc-above-110k-apr-2026",
  "title": "$BTC above $110,000 on Apr 5, 2026?",
  "type": "CLOB",
  "groupSlug": "btc-price-markets",
  "categoryIds": [1, 5],
  "createdAt": "2026-04-02T12:00:00.000Z"
}

Field	Type	Description
`slug`	`string`	Market slug identifier
`title`	`string`	Market title
`type`	`'AMM' \| 'CLOB'`	Market type
`groupSlug`	`string?`	Parent group slug (for NegRisk submarkets)
`categoryIds`	`number[]?`	Category IDs the market belongs to
`createdAt`	`string`	ISO-8601 creation timestamp

`marketResolved`

Emitted when a market resolves. Sent to both market_lifecycle subscribers and existing market:{slug} room subscribers.

{
  "slug": "btc-above-110k-apr-2026",
  "type": "CLOB",
  "winningOutcome": "YES",
  "winningIndex": 0,
  "resolutionDate": "2026-04-05T14:00:00.000Z"
}

Field	Type	Description
`slug`	`string`	Market slug identifier
`type`	`'AMM' \| 'CLOB'`	Market type
`winningOutcome`	`'YES' \| 'NO'`	The winning outcome
`winningIndex`	`0 \| 1`	Index of the winning outcome (0 = YES, 1 = NO)
`resolutionDate`	`string`	ISO-8601 resolution timestamp

WebSocket overview: connection details, handshake authentication, and the full event reference

Getting Started

Quick Start

TypeScript SDK

Python SDK

Go SDK

Rust SDK

WebSocket

Subscribing to market lifecycle events

Event payloads

`marketCreated`

`marketResolved`

​Subscribing to market lifecycle events

​Event payloads

​marketCreated

​marketResolved

​Related

Subscribing to market lifecycle events

Event payloads

`marketCreated`

`marketResolved`

Related