Skip to content

Info WebSocket

Public WebSocket endpoint for real-time market data requests without authentication.

Endpoint

ws.send() wss://api.synthetix.io/v1/ws/info

Real-time Market Data

  • Price Feeds: Live bid/ask prices and mid-market rates
  • Order Book: Full depth with real-time updates
  • Trades: Live trade stream with price, size, and side
  • Ticker: 24-hour rolling statistics

Market Information

  • Funding Rates: Current and predicted funding
  • Open Interest: Real-time position data
  • Liquidations: Live liquidation feed
  • Market Status: Trading halts and system status

Features

  • No authentication required
  • Low-latency streaming
  • Efficient delta updates
  • Snapshot + update pattern
  • Multiple subscription management

Message Format

Subscribe to Channels

{
  "id": "sub-1",
  "method": "subscribe",
  "params": {
    "type": "orderbook",
    "symbol": "BTC-USDT",
    "depth": 20
  }
}

Data Updates

{
  "method": "orderbook_depth_update",
  "data": {
    "symbol": "BTC-USDT",
    "timestamp": "2025-01-01T00:00:00.000Z",
    "bids": [
      {"price": "50000.00", "quantity": "1.5"},
      {"price": "49999.00", "quantity": "2.0"}
    ],
    "asks": [
      {"price": "50001.00", "quantity": "1.2"},
      {"price": "50002.00", "quantity": "1.8"}
    ]
  }
}

Connection Example

const ws = new WebSocket('wss://papi.synthetix.io/v1/ws/info');
 
ws.onopen = () => {
  // Subscribe to market data
  ws.send(JSON.stringify({
    id: "sub-1",
    method: "subscribe",
    params: {
      type: "orderbook",
      symbol: "BTC-USDT"
    }
  }));
};
 
ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Market update:', data);
};

Next Steps