# Websockets

## WebSockets

The platform provides two WebSocket endpoints for real-time data:

**Base URL**: `wss://v2.api.dexodus.finance`

### WS /ws-prices

Real-time price and market status updates.

#### Subscription Message

```json
{
  "action": "subscribe",
  "markets": ["BTC", "ETH", "SOL"]
}
```

**Parameters:**

* `action`: `"subscribe"` or `"unsubscribe"`
* `markets`: Array of markets you want to subscribe to. If empty, subscribes to all available markets.

#### Initial Snapshot Message

Server automatically sends initial data snapshot with current data for all markets.

```json
{
  "type": "initial_data_snapshot",
  "data": {
    "BTC": {
      "perpetualPrice": 45000.50,
      "indexPrice": 45010.25,
      "currentDate": "2024-01-15T10:30:00.000Z",
      "price24hAgo": 44500.00,
      "date24hAgo": "2024-01-14T10:30:00.000Z",
      "marketStatus": "Open"
    },
    "ETH": {
      "perpetualPrice": 2500.75,
      "indexPrice": 2502.50,
      "currentDate": "2024-01-15T10:30:00.000Z",
      "price24hAgo": 2450.00,
      "date24hAgo": "2024-01-14T10:30:00.000Z",
      "marketStatus": "Open"
    }
    // ... all other markets
  }
}
```

#### Real-time Update Message

Server sends price status update messages for real-time updates automatically when prices change.

```json
{
  "type": "price_status_update",
  "symbol": "BTC",
  "perpetualPrice": 45025.75,
  "indexPrice": 45030.00,
  "marketStatus": "Open",
  "timestamp": "2024-01-15T10:31:00.000Z"
}
```

### WS /ws

Real-time candlestick data.

#### Subscription Message

```json
{
  "action": "subscribe",
  "symbol": "BTC",
  "resolution": "1"
}
```

**Parameters:**

* `action`: `"subscribe"` or `"unsubscribe"`
* `symbol`: Symbol name
* `resolution`: Value is in minutes:
  * `"1"` - 1 minute candle
  * `"5"` - 5 minutes candle
  * `"240"` - 4 hours candle
  * `"1D"` - 1 day candle (exception)

#### Response Message

```json
{
  "symbol": "BTC",
  "resolution": "1m",
  "candle": {
    "time": 1234567890000,
    "open": 50000.0,
    "high": 50100.0,
    "low": 49900.0,
    "close": 50050.0
  }
}
```

**Candle Update Behavior:**

* All updates have the same `time` (e.g., `1759939376000`) for the same candle period
* The `close` price is constantly updating (represents the current price)
* The `high` and `low` update as new highs/lows are hit
* The `open` stays the same (price when the candle period started)