Analytics WebSocket

The snekfun-api-provider WebSocket uses Protocol v2: JSON text frames, explicit subscribe / unsubscribe envelopes (messageType, clientId, requestId, topic, optional data), plus connect / ping / pong for lifecycle. Auth: Public for most topics. Restricted flows (e.g. per-address history) may require appropriate subscription data — follow product security guidance.

Connection

Typical public URL: wss://analytics.snek.fun/websocket/ws
Application path: GET /ws on the WebSocket server port.

After connecting, send subscription messages. Outgoing frames wrap payloads in DefaultOutgoingMessage with event, messageType, and optional data (JSON mirrors server code: MainPage, PoolsFeed, KOTH, LiveOrdersFeed, UserHistoryByAddress, UserHistoryByAddressAndAsset).

topic	`data`	Purpose
`Latest`	omit	Main page — latest-updated pools
`New`	omit	Main page — newest listings
`MCapDesc`	omit	Main page — market cap descending
`CompletedCreateOn`	omit	Completed pools by creation time
`CompletedMCap`	omit	Completed pools by market cap
`KOTH`	omit	King of the Hill updates
`PoolFeed`	required	Single pool: `{ "asset": "{policy}.{hex}", "pkhFilter": null \| ["…"] }`
`LiveOrdersFeed`	required	Orders table: `{ "asset": "…", "pkhFilter": null \| ["…"] }`
`UserHistoryByAddress`	required	`{ "address": "addr1…" }`
`UserHistoryByAddressAndAsset`	required	`{ "address": "addr1…", "asset": "policy.hex" }`

PoolFeed data type is FeedByAssetData; live orders use the same shape.

{
  "messageType": "subscribe",
  "clientId": "app-1",
  "requestId": "sub-pool",
  "topic": "PoolFeed",
  "data": {
    "asset": "fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b.44415645",
    "pkhFilter": null
  }
}

Unsubscribe

{
  "messageType": "unsubscribe",
  "clientId": "app-1",
  "requestId": "sub-pool"
}

Connect / heartbeat

Use connect (messageType: connect) with clientId and requestId, and ping / pong (messageType: ping | pong) per the shared protocol implementation.

HTTP first

Fetch the matching initial state over HTTP (main page, pools feed, orders feed, or user history), then subscribe — see Main page, Pools feed, Orders feed, User history.

Overview

Analytics

Config

Transaction Builder API

UTXO Monitor

Connection

Unsubscribe

Connect / heartbeat

HTTP first

​Connection

​Topics (subscribe topic field)

​Subscribe example

​Unsubscribe

​Connect / heartbeat

​HTTP first

Connection

Topics (subscribe `topic` field)

Subscribe example

Unsubscribe

Connect / heartbeat

HTTP first