Skip to main content
WSS
wss://ws-live-data.kuest.com
Messages
Subscribe
type:object

Subscribe to live data topics.

Unsubscribe
type:object

Remove live data subscriptions.

Ping
type:string

Client keepalive ping (raw text).

Matched orders event
type:object
Comment event
type:object
Chainlink price event
type:object
Pong
type:string

Server response to ping (always PONG).

Live data streams deliver matched orders and comment events (per event or global), plus crypto price updates by symbol.

​
Endpoint

  • Production: wss://ws-live-data.kuest.com/

​
Heartbeats

Send any variation of PING (ping, PiNg, PING). The server replies with PONG.

​
Subscribe

Send a subscription payload immediately after opening the socket. 
{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "activity",
      "type": "orders_matched",
      "filters": { "event_slug": "x-banned-in-uk-by-march-31" }
    },
    {
      "topic": "comments",
      "type": "*",
      "filters": { "event_slug": "x-banned-in-uk-by-march-31" }
    },
    {
      "topic": "crypto_prices_chainlink",
      "type": "update",
      "filters": { "symbol": "btc/usd" }
    }
  ]
}
filters can be either a JSON object or a JSON string. Both are accepted. For activity subscriptions, type accepts orders_matched or * (alias for orders_matched). The event_slug filter is optional: omit it to receive the global feed. For comment subscriptions, type accepts comment_created, comment_removed, or * (alias for comment events). For crypto_prices_chainlink, type accepts update or * (alias for update).

​
Global feed example

{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "activity",
      "type": "orders_matched"
    }
  ]
}

​
Unsubscribe

{
  "action": "unsubscribe",
  "subscriptions": [
    {
      "topic": "activity",
      "type": "orders_matched",
      "filters": { "event_slug": "x-banned-in-uk-by-march-31" }
    }
  ]
}

​
Activity messages

Matched orders are delivered as orders_matched events with a payload object. 
{
  "connection_id": "ws-1710000000000-1",
  "topic": "activity",
  "type": "orders_matched",
  "timestamp": 1710000000000,
  "payload": {
    "bio": "",
    "name": "salted.caramel",
    "profileImage": "https://gateway.irys.xyz/u_MO35Chic67ttHdBqD-hMcAUBjppgGxMkdEY716TFg",
    "pseudonym": "",
    "proxyWallet": "0xe25b9180f5687aa85bd94ee309bb72a464320f1b",
    "side": "BUY",
    "asset": "1234",
    "conditionId": "0xabc",
    "size": 10.5,
    "price": 0.42,
    "timestamp": 1710000000,
    "transactionHash": "0xdeadbeef",
    "usdcSize": 4.41,
    "title": "Example market",
    "slug": "example-market",
    "icon": "https://cdn.kuest.com/markets/example.png",
    "eventSlug": "x-banned-in-uk-by-march-31",
    "tags": ["Politics", "Trump"],
    "outcome": "YES",
    "outcomeIndex": 0
  }
}
tags is an array of event labels you can use to filter on the client.

​
Comment messages

Comment events are delivered as comment_created or comment_removed. 
{
  "connection_id": "ws-1710000000000-1",
  "topic": "comments",
  "type": "comment_created",
  "timestamp": 1710000000000,
  "payload": {
    "id": "1763355",
    "body": "Example comment text",
    "createdAt": "2025-07-25T14:49:35.801298Z",
    "parentCommentID": "1763325",
    "parentEntityType": "Event",
    "profile": {
      "baseAddress": "0xce533188d53a16ed580fd5121dedf166d3482677",
      "displayUsernamePublic": true,
      "name": "salted.caramel",
      "profileImage": "https://gateway.irys.xyz/u_MO35Chic67ttHdBqD-hMcAUBjppgGxMkdEY716TFg",
      "proxyWallet": "0x4ca749dcfa93c87e5ee23e2d21ff4422c7a4c1ee",
      "pseudonym": "Adored-Disparity"
    },
    "positions": [
      {
        "conditionId": "0xabc",
        "outcomeIndex": 0,
        "amount": 10
      }
    ],
    "reactionCount": 0,
    "replyAddress": "0x0bda5d16f76cd1d3485bcc7a44bc6fa7db004cdd",
    "reportCount": 0,
    "userAddress": "0xce533188d53a16ed580fd5121dedf166d3482677"
  }
}

​
Crypto price messages

Chainlink price updates are delivered as update events with a payload object. 
{
  "connection_id": "ws-1710000000000-1",
  "topic": "crypto_prices_chainlink",
  "type": "update",
  "timestamp": 1710000000000,
  "payload": {
    "symbol": "btc/usd",
    "timestamp": 1710000000,
    "value": 65432.12
  }
}