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

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

1. Get a token

curl -s -X POST https://gateway.sandbox.architect.exchange/api/authenticate \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","api_secret":"YOUR_SECRET","expiration_seconds":3600}'
# Response: {"token":"<bearer-token>"}

2. Connect to the WebSocket

Pass the token as an Authorization header on the WebSocket upgrade request. Invalid or missing tokens are rejected with HTTP 401 before the connection is established.

# Store the token
TOKEN=$(curl -s -X POST https://gateway.sandbox.architect.exchange/api/authenticate \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","api_secret":"YOUR_SECRET","expiration_seconds":3600}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['token'])")

# Connect
wscat -c wss://gateway.sandbox.architect.exchange/md/ws \
  -H "Authorization: Bearer $TOKEN"

Replace gateway.sandbox.architect.exchange with gateway.architect.exchange for production. Once connected, send a subscribe message to start receiving market data:

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

Subscribe to candles for a symbol and interval:

{"rid":2,"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

User management

Symbols and instruments

Marketdata

Portfolio management

Order entry and management

Quickstart

1. Get a token

2. Connect to the WebSocket

Details

Request ID (`rid`)

Symbol fields in events

Heartbeat events

User management

Symbols and instruments

Marketdata

Portfolio management

Order entry and management

​Quickstart

​1. Get a token

​2. Connect to the WebSocket

​3. Subscribe

​Details

​Request ID (rid)

​Symbol fields in events

​Heartbeat events

Quickstart

1. Get a token

2. Connect to the WebSocket

3. Subscribe

Details

Request ID (`rid`)

Symbol fields in events

Heartbeat events