Skip to main content
The Tide WebSocket API provides real-time updates for market data and account information. Connect to receive live order book updates, trade executions, position changes, and more.

​
Connection

​
WebSocket Endpoint

wss://api.tide.ag/ws

​
Connection Example

const WebSocket = require('ws');

const ws = new WebSocket('wss://api.tide.ag/ws');

ws.on('open', function open() {
  console.log('Connected to Tide WebSocket');
});

ws.on('message', function message(data) {
  const update = JSON.parse(data);
  console.log('Received:', update);
});

​
Authentication

Public streams work without Tide API credentials. Private streams may require an authentication message after connect when signing is enforced—check stream documentation for your use case. When auth is required, send the message below immediately after connection.

​
Authentication Message

{
  "method": "auth",
  "params": {
    "apiKey": "your_api_key",
    "timestamp": 1698765432000,
    "signature": "hmac_sha256_signature"
  }
}

​
Public Streams

​
Order Book Updates

Topic: orderbook:{symbol} Subscribe to real-time order book updates for a specific symbol. 
{
  "method": "subscribe",
  "params": {
    "topic": "orderbook:BTC-USD",
    "exchanges": ["hyperliquid", "aster"],
    "depth": 20
  }
}

​
Trade Updates

Topic: trades:{symbol} Subscribe to real-time trade executions for a specific symbol. 
{
  "method": "subscribe",
  "params": {
    "topic": "trades:BTC-USD",
    "exchanges": ["hyperliquid", "aster"]
  }
}

​
Private Streams

​
Order Updates

Topic: orders Subscribe to real-time updates for your orders. 
{
  "method": "subscribe",
  "params": {
    "topic": "orders",
    "symbols": ["BTC-USD", "ETH-USD"]
  }
}

​
Position Updates

Topic: positions Subscribe to real-time position updates. 
{
  "method": "subscribe",
  "params": {
    "topic": "positions",
    "symbols": ["BTC-USD", "ETH-USD"]
  }
}

​
Rate Limits

  • Connections: 5 simultaneous connections per client
  • Subscriptions per connection: 50 topics
  • Messages per second: 100 outbound messages
For complete WebSocket documentation including authentication, error handling, and reconnection strategies, see our comprehensive WebSocket guide.