WebSocket Introduction

Overview

The Public WebSocket API provides real-time data subscription functionality, supporting subscriptions for order books, K-lines, instrument information, portfolios, and more.

Connection URL

wss://api.monday.trade/v4/public/ws

Heartbeat Mechanism

Clients can send a "ping" string to keep the connection alive. The server will reply with "pong".

Message Format

Request Message Format

All request messages follow this format:

{
  "id": <number>,           // Request ID for matching responses
  "method": "SUBSCRIBE" | "UNSUBSCRIBE",
  "params": {
    // Specific parameters vary by subscription type
  }
}

Response Message Format

Subscribe/Unsubscribe Response

{
  "id": <number>,           // Corresponding request ID
  "result": "success"
}

Data Stream Message Format

{
  "stream": "<stream_type>",  // Stream type: orderBook, kline, instrument, portfolio, blockNumChanged, marketListChanged, marketPairInfoChanged
  "chainId": <number>,        // Optional: present for instrument-scoped streams (orderBook, kline, instrument, marketPairInfoChanged)
  "instrument": "<address>",  // Optional: present for instrument-scoped streams
  "expiry": <number>,         // Optional: present for instrument-scoped streams
  "data": {
    // Specific data varies by subscription type
  }
}

Subscription Types

The WebSocket API supports the following subscription types:

1. K-line Data Subscription (kline) - Subscribe to K-line data updates for a specific instrument and interval

2. Order Book Subscription (orderBook) - Subscribe to order book data updates for a specific instrument

3. Instrument Information Subscription (instrument) - Subscribe to detailed instrument information updates

4. Portfolio Subscription (portfolio) - Subscribe to portfolio update notifications for a specific user address

5. Common Subscription (common) - Subscribe to chain-level common events, including block number changes and market list changes

6. Instrument Basic Info Subscription (instrumentBasicInfo) - Subscribe to basic instrument information updates

For detailed information about each subscription type, please refer to the corresponding documentation files.