{
"type": "hello",
"requestId": "5c1d7e2a0b8f4c439d612f7a3e1b9c04",
"timestamp": 1787900000,
"payload": {
"publicKey": "7xKXtg2C…",
"nonce": "a3f9c1e7-6d2b-4e8a-b5f0-1c9d8e7a6b53"
},
"signature": "3jK9…"
}{
"type": "ping",
"requestId": "f0019a3c2b7e4d10a8c65e4f3d2c1b0a"
}{
"type": "welcome",
"requestId": "5c1d7e2a0b8f4c439d612f7a3e1b9c04",
"traceId": "partners-rt-gw-9f2c1b04-3e7d-4a1b-8c55-6d0e2f9a7b31",
"sentAt": "2026-09-01T14:33:51.868Z",
"payload": {
"sessionId": "s-7f31a0",
"serverTime": 1787900001,
"heartbeatSeconds": 10
}
}{
"type": "pong",
"requestId": "f0019a3c2b7e4d10a8c65e4f3d2c1b0a",
"traceId": "partners-rt-gw-2b8e4f61-9a0c-4d37-b2e5-7c1a6f3d8e90",
"sentAt": "2026-09-01T14:36:31.102Z",
"payload": {
"serverTime": 1787900160
}
}{
"type": "error",
"requestId": "7a02c4e158b34f9da0e23c6b1d7f8e45",
"traceId": "partners-rt-gw-4d81e0a7-2c6f-4b19-9e3a-8f5d1c7b0a62",
"sentAt": "2026-08-28T15:29:47.012Z",
"payload": {
"code": "INVALID_ORDER",
"message": "The reference ref-2026-08-28-0001 already names an order (FILLED): look it up instead of placing it again"
}
}Session
Open the socket, sign hello, and keep the session alive with ping.
wss://partners-rt-gw.sandbox.securitize.io/v1/market-maker/stream, send a signed hello within 10 seconds, and wait for welcome; any other well-formed message first is refused with UNAUTHENTICATED and closes the socket, while a malformed frame answers MALFORMED and the socket stays open. Send ping every 10 seconds. One socket is one session. See Sandbox and authentication for signing and a working example.{
"type": "hello",
"requestId": "5c1d7e2a0b8f4c439d612f7a3e1b9c04",
"timestamp": 1787900000,
"payload": {
"publicKey": "7xKXtg2C…",
"nonce": "a3f9c1e7-6d2b-4e8a-b5f0-1c9d8e7a6b53"
},
"signature": "3jK9…"
}{
"type": "ping",
"requestId": "f0019a3c2b7e4d10a8c65e4f3d2c1b0a"
}{
"type": "welcome",
"requestId": "5c1d7e2a0b8f4c439d612f7a3e1b9c04",
"traceId": "partners-rt-gw-9f2c1b04-3e7d-4a1b-8c55-6d0e2f9a7b31",
"sentAt": "2026-09-01T14:33:51.868Z",
"payload": {
"sessionId": "s-7f31a0",
"serverTime": 1787900001,
"heartbeatSeconds": 10
}
}{
"type": "pong",
"requestId": "f0019a3c2b7e4d10a8c65e4f3d2c1b0a",
"traceId": "partners-rt-gw-2b8e4f61-9a0c-4d37-b2e5-7c1a6f3d8e90",
"sentAt": "2026-09-01T14:36:31.102Z",
"payload": {
"serverTime": 1787900160
}
}{
"type": "error",
"requestId": "7a02c4e158b34f9da0e23c6b1d7f8e45",
"traceId": "partners-rt-gw-4d81e0a7-2c6f-4b19-9e3a-8f5d1c7b0a62",
"sentAt": "2026-08-28T15:29:47.012Z",
"payload": {
"code": "INVALID_ORDER",
"message": "The reference ref-2026-08-28-0001 already names an order (FILLED): look it up instead of placing it again"
}
}Each client registers an Ed25519 public key with Securitize beforehand; the private key never leaves the client. hello, place_order, cancel_order, submit_crypto_funding, sandbox_deposit and sandbox_withdraw carry timestamp (Unix seconds) and signature = base58( Ed25519-Sign( privateKey, timestamp + "." + type + "." + payloadBytes ) ), where payloadBytes are the exact bytes of payload as sent on the wire. The timestamp must be within 30 seconds of the server clock. Other messages ride on the session hello opens.
Opens the session. Signed. The first message on every connection.
Heartbeat. Send one every 10 seconds.
The session is open.
Answers ping, with the server clock.
A request was refused. Most errors leave the socket open.