Use the PoolTheWool WebSocket API to receive realtime ticker, kline, and trade updates in the frontend.

Production endpoint

wss://ws.poolthewool.com/ws

Health endpoint

https://ws.poolthewool.com/health

What You Can Stream

  • 24 hour ticker updates for one market, or all tickers.
  • Closed kline candles by market and interval.
  • Recent executed trades by market.

Browser Origins

Production connections are accepted from the configured frontend origins:
  • https://www.poolthewool.com
  • https://poolthewool.com
  • https://nafas.poolthewool.com
If the browser sends another Origin, the WebSocket upgrade is rejected.

Basic Flow

  1. Open a WebSocket connection to wss://ws.poolthewool.com/ws.
  2. Send a subscribe message for each channel the UI needs.
  3. Listen for subscribed, data, pong, and error messages.
  4. Reconnect with backoff when the socket closes.
{
  "type": "subscribe",
  "channel": "ticker:BTCUSDT",
  "id": 1
}
{
  "type": "subscribed",
  "channel": "ticker:BTCUSDT",
  "id": 1,
  "timestamp": 1780816696007
}