WebSocket Streams

• The base URL for all WSS interfaces listed in this document is: wss://ws.dotswap.app

  • The testnet base URL is: wss://test-api-proxy.ddpurse.com:28910

• All streams can be accessed directly or as part of combined streams.

• Direct access URL format: /ws/

• Combined streams URL format: /stream?streams=,,

• When subscribing to combined streams, event payloads are wrapped in this format: {"stream":"","data":}

• Each connection to ws.dotswap.app has a validity period of no more than 24 hours. Please handle reconnection properly.

• All time and timestamp related fields use milliseconds as the default unit.

Ticker by Symbol (Single Trading Pair)

Stream Name: @trade

// Subscribe to DOTSWAP•DOTSWAP/BTC ticker

const wsDSBTC = new WebSocket("wss://ws.dotswap.app/ws/DOTSWAP•DOTSWAP/BTC@trade");

wsDSBTC.onmessage = (event) => {
    const data = JSON.parse(event.data);
    console.log("DOTSWAP•DOTSWAP/BTC ticker:", data);
};

Payload:

{
    "e": "trade", // Event type
    "E": 1763975983770, // Event time
    "s": "DOTSWAP•DOTSWAP/BTC", // Trading pair
    "p": "918.209", // Trade price
    "q": "1000", // Trade quantity
    "T": 1763975975000 // Trade time
}

Ticker by Symbol (Multiple Trading Pairs)

Stream Name: @trade

// Subscribe to DOTSWAP•DOTSWAP/BTC and DOG•GO•TO•THE•MOON/BTC tickers at once

const ws = new WebSocket(
"wss://ws.dotswap.app/stream?streams=DOTSWAP•DOTSWAP/BTC@trade,DOG•GO•TO•THE•MOON/BTC@trade"
);

ws.onmessage = (event) => {
    const message = JSON.parse(event.data);
    console.log("Received data:", message.stream, message.data);
};

Payload:

{
"stream": "DOTSWAP•DOTSWAP/BTC@trade",
"data": {
  "e": "trade", // Event type
  "E": 1763975983770, // Event time
  "s": "DOTSWAP•DOTSWAP/BTC", // Trading pair
  "p": "918.209", // Trade price
  "q": "1000", // Trade quantity
  "T": 1763975975000 // Trade time
 }
}