Subscribe

This request adds one or more streams to the current WebSocket connection.

Request

{
  "message":"subscribe",
  "content":{
    "clientRequestId":"cfff0f58-8780-4cf2-b3d3-6439fed37304",
    "subscriptions":[
      "trades",
      "publicTrades",
      "publicOrderBook"
    ]
  }
}

Field	Type	Required	Description
message	string	Yes	subscribe
content.clientRequestId	string	No	Client-generated UUID for correlation
content.subscriptions	array	Yes	One or more subscriptions to add

Response

{
    "data": {
        "activeSubscriptions": [
            "orders",
            "trades",
            "publicTrades",
            "publicOrderBook"
        ],
        "clientRequestId": "cfff0f58-8780-4cf2-b3d3-6439fed37304",
        "requestedSubscriptions": [
            "trades",
            "publicTrades",
            "publicOrderBook"
        ]
    },
    "resultType": "subscribed"
}

Field	Type	Required	Description
data.activeSubscriptions	array	Yes	All currently active subscriptions after the operation
data.clientRequestId	string	No	Client-generated UUID for correlation
data.requestedSubscriptions	array	Yes	The specific subscriptions that were requested to be added
resultType	string	Yes	subscribed

Allowed Subscription Values

Subscription Value	Description
orders	Order creation and cancellation requests and notifications
trades	Real-time trade updates for your account
publicTrades	Real-time trade updates and snapshots for subscribed markets
publicOrderBook	Real-time order book updates and snapshots for subscribed markets

Behavior

• Only new subscriptions are added to the connection
• Re-subscribing to an already active subscription is a no-op
• Existing subscriptions remain unaffected
• Changes apply immediately
• Safe to call repeatedly (idempotent)
• Does not affect other connections
• Does not require reconnecting