Websocket marketdata

Messages

{
  "t": "s",
  "ts": 1609459200,
  "tn": 123456789,
  "s": "BTCUSD-PERP",
  "p": "50000.00",
  "q": 100,
  "o": "49500.00",
  "l": "49000.00",
  "h": "50500.00",
  "v": 125000,
  "oi": 50000,
  "m": "50010.00",
  "i": "OPEN",
  "pl": "47500.00",
  "pu": "52500.00"
}

{
  "t": "c",
  "symbol": "BTCUSD-PERP",
  "ts": 123456789,
  "open": "49500.00",
  "low": "49000.00",
  "high": "50500.00",
  "close": "50000.00",
  "volume": 5000,
  "buy_volume": 3000,
  "sell_volume": 2000,
  "width": "1m"
}

{
  "t": "2",
  "ts": 1609459200,
  "tn": 123456789,
  "s": "BTCUSD-PERP",
  "b": [
    {
      "p": "49999.50",
      "q": 500
    },
    {
      "p": "49999.00",
      "q": 300
    },
    {
      "p": "49998.50",
      "q": 200
    },
    {
      "p": "49998.00",
      "q": 150
    },
    {
      "p": "49997.50",
      "q": 100
    }
  ],
  "a": [
    {
      "p": "50000.50",
      "q": 300
    },
    {
      "p": "50001.00",
      "q": 400
    },
    {
      "p": "50001.50",
      "q": 250
    },
    {
      "p": "50002.00",
      "q": 200
    },
    {
      "p": "50002.50",
      "q": 150
    }
  ],
  "st": true
}

{
  "t": "3",
  "ts": 1609459200,
  "tn": 123456789,
  "s": "BTCUSD-PERP",
  "b": [
    {
      "p": "49999.50",
      "q": 500,
      "o": [
        200,
        150,
        100,
        50
      ]
    },
    {
      "p": "49999.00",
      "q": 300,
      "o": [
        150,
        100,
        50
      ]
    },
    {
      "p": "49998.50",
      "q": 200,
      "o": [
        100,
        100
      ]
    }
  ],
  "a": [
    {
      "p": "50000.50",
      "q": 300,
      "o": [
        150,
        100,
        50
      ]
    },
    {
      "p": "50001.00",
      "q": 400,
      "o": [
        200,
        150,
        50
      ]
    },
    {
      "p": "50001.50",
      "q": 250,
      "o": [
        150,
        100
      ]
    }
  ],
  "st": true
}

WSS

wss://gateway.sandbox.architect.exchange

Messages

{
  "t": "s",
  "ts": 1609459200,
  "tn": 123456789,
  "s": "BTCUSD-PERP",
  "p": "50000.00",
  "q": 100,
  "o": "49500.00",
  "l": "49000.00",
  "h": "50500.00",
  "v": 125000,
  "oi": 50000,
  "m": "50010.00",
  "i": "OPEN",
  "pl": "47500.00",
  "pu": "52500.00"
}

{
  "t": "c",
  "symbol": "BTCUSD-PERP",
  "ts": 123456789,
  "open": "49500.00",
  "low": "49000.00",
  "high": "50500.00",
  "close": "50000.00",
  "volume": 5000,
  "buy_volume": 3000,
  "sell_volume": 2000,
  "width": "1m"
}

{
  "t": "2",
  "ts": 1609459200,
  "tn": 123456789,
  "s": "BTCUSD-PERP",
  "b": [
    {
      "p": "49999.50",
      "q": 500
    },
    {
      "p": "49999.00",
      "q": 300
    },
    {
      "p": "49998.50",
      "q": 200
    },
    {
      "p": "49998.00",
      "q": 150
    },
    {
      "p": "49997.50",
      "q": 100
    }
  ],
  "a": [
    {
      "p": "50000.50",
      "q": 300
    },
    {
      "p": "50001.00",
      "q": 400
    },
    {
      "p": "50001.50",
      "q": 250
    },
    {
      "p": "50002.00",
      "q": 200
    },
    {
      "p": "50002.50",
      "q": 150
    }
  ],
  "st": true
}

{
  "t": "3",
  "ts": 1609459200,
  "tn": 123456789,
  "s": "BTCUSD-PERP",
  "b": [
    {
      "p": "49999.50",
      "q": 500,
      "o": [
        200,
        150,
        100,
        50
      ]
    },
    {
      "p": "49999.00",
      "q": 300,
      "o": [
        150,
        100,
        50
      ]
    },
    {
      "p": "49998.50",
      "q": 200,
      "o": [
        100,
        100
      ]
    }
  ],
  "a": [
    {
      "p": "50000.50",
      "q": 300,
      "o": [
        150,
        100,
        50
      ]
    },
    {
      "p": "50001.00",
      "q": 400,
      "o": [
        200,
        150,
        50
      ]
    },
    {
      "p": "50001.50",
      "q": 250,
      "o": [
        150,
        100
      ]
    }
  ],
  "st": true
}

Subscribe Request

type:object

Subscribe to market data for a symbol

Unsubscribe Request

type:object

Unsubscribe from market data for a symbol

Subscribe Candle Request

type:object

Subscribe to candle udpates on a symbol and width

Unsubscribe Candle Request

type:object

Unsubscribe from candle udpates on a symbol and width

Success Response

type:object

Confirmation of a successful client request

Error Response

type:object

Response indicating a failed client request

Heartbeat Event

type:object

Heartbeat/timestamp event (t="h")

Ticker Event

type:object

Ticker statistics update (t="s")

Trade Event

type:object

Trade event (t="t")

Candle Event

type:object

Candle update (t="c")

Level 1 Book Update Event

type:object

Level 1 orderbook update - best bid/ask (t="1")

Level 2 Book Update Event

type:object

Level 2 orderbook update - aggregated price levels (t="2")

Level 3 Book Update Event

type:object

Level 3 orderbook update - individual order quantities (t="3")

Quickstart

Subscribe to order book + ticker + trades for a symbol:

{
  "rid": 2,
  "type": "subscribe",
  "symbol": "BTCUSD-PERP",
  "level": "LEVEL_2"
}

Subscribe to candles for a symbol and interval:

{
  "rid": 4,
  "type": "subscribe_candles",
  "symbol": "BTCUSD-PERP",
  "width": "1m"
}

After a successful subscribe, you receive:

Ticker updates (t = "s")
Trade updates (t = "t")
Order book updates matching your selected level:
- LEVEL_1 -> t = "1"
- LEVEL_2 -> t = "2"
- LEVEL_3 -> t = "3"

After a successful subscribe_candles, you receive candle updates (t = "c").

Details

Request ID (`rid`)

rid is used to correlate request/response pairs.
Server acknowledgements and request errors include the same rid as your request.
Market data events do not include rid.

Symbol fields in events

Ticker, trade, and order book events use s for symbol.
Candle events use symbol.

Heartbeat events

The server emits heartbeat events (t = "h"):

{
  "t": "h",
  "ts": 1609459200,
  "tn": 123456789
}

Use heartbeat and market data flow to monitor connection health.

Get funding rates Get balances

⌘I

User management

Symbols and instruments

Marketdata

Portfolio management

Order entry and management

Quickstart

Details

Request ID (`rid`)

Symbol fields in events

Heartbeat events

User management

Symbols and instruments

Marketdata

Portfolio management

Order entry and management

​Quickstart

​Details

​Request ID (rid)

​Symbol fields in events

​Heartbeat events

Quickstart

Details

Request ID (`rid`)

Symbol fields in events

Heartbeat events