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 scoped to a single event slug, plus crypto price updates keyed 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). For comment subscriptions, type accepts comment_created or * (alias for comment_created). For crypto_prices_chainlink, type accepts update or * (alias for update).

​
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 array. 
{
  "connection_id": "ws-1710000000000-1",
  "topic": "activity",
  "type": "orders_matched",
  "timestamp": 1710000000000,
  "payload": [
    {
      "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",
      "outcome": "YES",
      "outcomeIndex": 0
    }
  ]
}

​
Comment messages

Comment events are delivered as comment_created. 
{
  "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",
      "proxyWallet": "0x4ca749dcfa93c87e5ee23e2d21ff4422c7a4c1ee",
      "pseudonym": "Adored-Disparity"
    },
    "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
  }
}