Messages
{
"type": "place_order",
"requestId": "7a02c4e158b34f9da0e23c6b1d7f8e45",
"timestamp": 1787900123,
"payload": {
"side": "B",
"symbol": "AAPL",
"quantity": "10",
"orderType": "LIMIT",
"limitPrice": "150.0000",
"externalRef": "ref-2026-08-28-0001"
},
"signature": "9Pq2…"
}{
"type": "get_symbols",
"requestId": "5e21d9a03c7b4f68a1e40b9c2d7f3a16"
}{
"type": "get_redemption_address",
"requestId": "8d3f1a6b2c9e4f07b5a1d2e3c4f5a6b7",
"payload": {
"symbol": "AAPL",
"chainId": 196
}
}{
"type": "get_redemption_balance",
"requestId": "4b8e2d7f1a3c4e5f9a0b1c2d3e4f5a6b",
"payload": {
"symbol": "AAPL",
"chainId": 196
}
}{
"type": "get_redemption_balances",
"requestId": "6c1f3a9d2e7b4c58a0d1e2f3a4b5c6d7"
}{
"type": "cancel_order",
"requestId": "b19f3a7c6e2d4f81a5b09c4e7d1f2a38",
"timestamp": 1787900140,
"payload": {
"orderId": "3396877"
},
"signature": "Lm4x…"
}{
"type": "get_order",
"requestId": "e4404b2d7c9a4e158f3b1a6d0c5e9b72",
"payload": {
"orderId": "3396877"
}
}{
"type": "ack",
"for": "place_order",
"requestId": "7a02c4e158b34f9da0e23c6b1d7f8e45",
"traceId": "partners-rt-gw-4d81e0a7-2c6f-4b19-9e3a-8f5d1c7b0a62",
"sentAt": "2026-08-28T15:29:47.012Z",
"payload": {
"orderId": "3396877",
"regulatoryId": "ec6c1265-8dc2-4bca-8f67-2e6206e3f39b",
"externalRef": "ref-2026-08-28-0001",
"tokenAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"chainId": 101,
"status": "ACCEPTED"
}
}{
"type": "ack",
"for": "get_symbols",
"requestId": "5e21d9a03c7b4f68a1e40b9c2d7f3a16",
"traceId": "partners-rt-gw-3c8e1f52-7a4d-4b90-9e26-1d5f0b7c8a43",
"sentAt": "2026-10-19T13:04:12.318Z",
"payload": {
"symbols": [
{
"symbol": "AAPL",
"chains": [
{
"chainId": 101,
"tokenAddress": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"isin": "US0378331005",
"cusip": "037833100"
},
{
"chainId": 196,
"tokenAddress": "0x1111111111111111111111111111111111111111",
"isin": "US0378331005",
"cusip": "037833100"
}
]
},
{
"symbol": "MSFT",
"chains": [
{
"chainId": 101
}
]
}
]
}
}{
"type": "ack",
"for": "get_redemption_address",
"requestId": "8d3f1a6b2c9e4f07b5a1d2e3c4f5a6b7",
"traceId": "partners-rt-gw-6a1d4e8b-2f7c-4b39-a0e5-9c3d1b7f2e64",
"sentAt": "2026-10-21T16:20:05.411Z",
"payload": {
"symbol": "AAPL",
"chainId": 196,
"tokenAddress": "0x1111111111111111111111111111111111111111",
"redemptionAddress": "0x2222222222222222222222222222222222222222"
}
}{
"type": "ack",
"for": "get_redemption_balance",
"requestId": "4b8e2d7f1a3c4e5f9a0b1c2d3e4f5a6b",
"traceId": "partners-rt-gw-3f9a1c7e-5b2d-4e8a-9c6f-1d2e3f4a5b6c",
"sentAt": "2026-10-22T14:02:41.207Z",
"payload": {
"symbol": "AAPL",
"chainId": 196,
"deposited": "250",
"burned": "100",
"reserved": "40",
"available": "110"
}
}{
"type": "ack",
"for": "get_redemption_balances",
"requestId": "6c1f3a9d2e7b4c58a0d1e2f3a4b5c6d8",
"traceId": "partners-rt-gw-8e2b4d6f-1a3c-4e5f-9b7d-2c4e6a8b0d1f",
"sentAt": "2026-10-28T10:15:22.031Z",
"payload": {
"balances": [
{
"symbol": "AAPL",
"chainId": 196,
"deposited": "250",
"burned": "100",
"reserved": "40",
"available": "110"
},
{
"symbol": "AMZN",
"chainId": 196,
"deposited": "5",
"burned": "5",
"reserved": "0",
"available": "0"
}
]
}
}{
"type": "ack",
"for": "cancel_order",
"requestId": "b19f3a7c6e2d4f81a5b09c4e7d1f2a38",
"traceId": "partners-rt-gw-b70c2f19-8d4a-4e63-a1f7-5b2c9e0d3f84",
"sentAt": "2026-08-28T15:29:58.441Z",
"payload": {
"orderId": "3396877",
"status": "PENDING_CANCEL"
}
}{
"type": "ack",
"for": "get_order",
"requestId": "e4404b2d7c9a4e158f3b1a6d0c5e9b72",
"traceId": "partners-rt-gw-1a55d3c8-6f0e-4b72-a9d4-3c8e1f5b7a20",
"sentAt": "2026-08-28T15:31:02.517Z",
"payload": {
"orderId": "3396877",
"regulatoryId": "ec6c1265-8dc2-4bca-8f67-2e6206e3f39b",
"externalRef": "ref-2026-08-28-0001",
"status": "PARTIALLY_FILLED",
"brokerStatus": "PARTIALLY_FILLED",
"side": "B",
"symbol": "AAPL",
"tokenAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"chainId": 101,
"orderType": "LIMIT",
"timeInForce": "DAY",
"quantity": "10",
"executedQuantity": "4",
"leavesQuantity": "6",
"limitPrice": "150.25",
"executedPrice": "150.25",
"currency": "USD",
"createdAt": "2026-08-28T15:29:46.936Z",
"mints": [],
"burns": [],
"fees": [
{
"transactionNo": "12874152.000000",
"reference": "fee.12874152",
"amount": "0.01",
"perShare": "0.003",
"status": "BOOKED",
"chargedAt": "2026-08-28T15:30:03.112Z",
"bookedAt": "2026-08-28T15:31:01.529Z"
}
],
"feeTotal": "0.01"
}
}{
"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"
}
}{
"type": "order_updated",
"traceId": "partners-rt-gw-c3e9a11f-5b2d-4e7a-8f60-9d1c4b3e2a75",
"sentAt": "2026-09-03T20:29:15.654Z",
"payload": {
"orderId": "3402360",
"regulatoryId": "1a68ac30-3931-4261-a98e-8d0eea53ca20",
"externalRef": "ref-2026-09-03-0001",
"status": "FILLED",
"brokerStatus": "FILLED",
"side": "B",
"symbol": "AAPL",
"tokenAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"chainId": 101,
"quantity": "250",
"executedQuantity": "250",
"leavesQuantity": "0.000000",
"executedPrice": "325.13",
"currency": "USD",
"createdAt": "2026-09-03T20:29:13.737Z",
"occurredAt": "2026-09-03T20:29:15.654Z"
}
}{
"type": "trade_updated",
"traceId": "partners-rt-gw-a3c9b7ee-4d1f-4a82-b6e0-2f8c5d9a1e37",
"sentAt": "2026-09-03T20:30:01.858Z",
"payload": {
"tradeId": "12874158.000000",
"orderRegulatoryId": "1a68ac30-3931-4261-a98e-8d0eea53ca20",
"side": "B",
"symbol": "AAPL",
"tokenAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"chainId": 101,
"quantity": "50.00000000",
"grossAmount": "16256.500000",
"netAmount": "16256.500000",
"price": "325.13",
"currency": "USD",
"settled": false,
"settleDate": "2026-09-04T04:00:00.000Z",
"brokerStatus": "R",
"tradeDate": "2026-09-03T04:00:00.000Z",
"executedAt": "2026-09-03T20:29:38.487Z",
"occurredAt": "2026-09-03T20:30:01.529Z"
}
}API reference
Orders
List the symbols you can trade, place, cancel and look up orders, and receive order and trade updates.
WSS
/
v1
/
market-maker
/
stream
get_symbols lists the symbols you can trade and the chains each one can be bought on; a symbol listed on more than one chain needs chainId on place_order. get_redemption_address answers where to send a CET’s tokens before selling, get_redemption_balance how many of the ones you sent you can still sell, and get_redemption_balances the same for every CET at once: see Sell shares and redeem CETs.
An ack to place_order means the order was taken, not that it filled. A buy the account cannot pay for, or a sell your redemption balance cannot cover, is refused with INVALID_ORDER before it reaches the broker. Once taken, its fills arrive as order_updated and trade_updated, pushed at most once and never replayed. After any gap, get_order says where an order stands. See Track, cancel and reconcile orders.Messages
{
"type": "place_order",
"requestId": "7a02c4e158b34f9da0e23c6b1d7f8e45",
"timestamp": 1787900123,
"payload": {
"side": "B",
"symbol": "AAPL",
"quantity": "10",
"orderType": "LIMIT",
"limitPrice": "150.0000",
"externalRef": "ref-2026-08-28-0001"
},
"signature": "9Pq2…"
}{
"type": "get_symbols",
"requestId": "5e21d9a03c7b4f68a1e40b9c2d7f3a16"
}{
"type": "get_redemption_address",
"requestId": "8d3f1a6b2c9e4f07b5a1d2e3c4f5a6b7",
"payload": {
"symbol": "AAPL",
"chainId": 196
}
}{
"type": "get_redemption_balance",
"requestId": "4b8e2d7f1a3c4e5f9a0b1c2d3e4f5a6b",
"payload": {
"symbol": "AAPL",
"chainId": 196
}
}{
"type": "get_redemption_balances",
"requestId": "6c1f3a9d2e7b4c58a0d1e2f3a4b5c6d7"
}{
"type": "cancel_order",
"requestId": "b19f3a7c6e2d4f81a5b09c4e7d1f2a38",
"timestamp": 1787900140,
"payload": {
"orderId": "3396877"
},
"signature": "Lm4x…"
}{
"type": "get_order",
"requestId": "e4404b2d7c9a4e158f3b1a6d0c5e9b72",
"payload": {
"orderId": "3396877"
}
}{
"type": "ack",
"for": "place_order",
"requestId": "7a02c4e158b34f9da0e23c6b1d7f8e45",
"traceId": "partners-rt-gw-4d81e0a7-2c6f-4b19-9e3a-8f5d1c7b0a62",
"sentAt": "2026-08-28T15:29:47.012Z",
"payload": {
"orderId": "3396877",
"regulatoryId": "ec6c1265-8dc2-4bca-8f67-2e6206e3f39b",
"externalRef": "ref-2026-08-28-0001",
"tokenAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"chainId": 101,
"status": "ACCEPTED"
}
}{
"type": "ack",
"for": "get_symbols",
"requestId": "5e21d9a03c7b4f68a1e40b9c2d7f3a16",
"traceId": "partners-rt-gw-3c8e1f52-7a4d-4b90-9e26-1d5f0b7c8a43",
"sentAt": "2026-10-19T13:04:12.318Z",
"payload": {
"symbols": [
{
"symbol": "AAPL",
"chains": [
{
"chainId": 101,
"tokenAddress": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"isin": "US0378331005",
"cusip": "037833100"
},
{
"chainId": 196,
"tokenAddress": "0x1111111111111111111111111111111111111111",
"isin": "US0378331005",
"cusip": "037833100"
}
]
},
{
"symbol": "MSFT",
"chains": [
{
"chainId": 101
}
]
}
]
}
}{
"type": "ack",
"for": "get_redemption_address",
"requestId": "8d3f1a6b2c9e4f07b5a1d2e3c4f5a6b7",
"traceId": "partners-rt-gw-6a1d4e8b-2f7c-4b39-a0e5-9c3d1b7f2e64",
"sentAt": "2026-10-21T16:20:05.411Z",
"payload": {
"symbol": "AAPL",
"chainId": 196,
"tokenAddress": "0x1111111111111111111111111111111111111111",
"redemptionAddress": "0x2222222222222222222222222222222222222222"
}
}{
"type": "ack",
"for": "get_redemption_balance",
"requestId": "4b8e2d7f1a3c4e5f9a0b1c2d3e4f5a6b",
"traceId": "partners-rt-gw-3f9a1c7e-5b2d-4e8a-9c6f-1d2e3f4a5b6c",
"sentAt": "2026-10-22T14:02:41.207Z",
"payload": {
"symbol": "AAPL",
"chainId": 196,
"deposited": "250",
"burned": "100",
"reserved": "40",
"available": "110"
}
}{
"type": "ack",
"for": "get_redemption_balances",
"requestId": "6c1f3a9d2e7b4c58a0d1e2f3a4b5c6d8",
"traceId": "partners-rt-gw-8e2b4d6f-1a3c-4e5f-9b7d-2c4e6a8b0d1f",
"sentAt": "2026-10-28T10:15:22.031Z",
"payload": {
"balances": [
{
"symbol": "AAPL",
"chainId": 196,
"deposited": "250",
"burned": "100",
"reserved": "40",
"available": "110"
},
{
"symbol": "AMZN",
"chainId": 196,
"deposited": "5",
"burned": "5",
"reserved": "0",
"available": "0"
}
]
}
}{
"type": "ack",
"for": "cancel_order",
"requestId": "b19f3a7c6e2d4f81a5b09c4e7d1f2a38",
"traceId": "partners-rt-gw-b70c2f19-8d4a-4e63-a1f7-5b2c9e0d3f84",
"sentAt": "2026-08-28T15:29:58.441Z",
"payload": {
"orderId": "3396877",
"status": "PENDING_CANCEL"
}
}{
"type": "ack",
"for": "get_order",
"requestId": "e4404b2d7c9a4e158f3b1a6d0c5e9b72",
"traceId": "partners-rt-gw-1a55d3c8-6f0e-4b72-a9d4-3c8e1f5b7a20",
"sentAt": "2026-08-28T15:31:02.517Z",
"payload": {
"orderId": "3396877",
"regulatoryId": "ec6c1265-8dc2-4bca-8f67-2e6206e3f39b",
"externalRef": "ref-2026-08-28-0001",
"status": "PARTIALLY_FILLED",
"brokerStatus": "PARTIALLY_FILLED",
"side": "B",
"symbol": "AAPL",
"tokenAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"chainId": 101,
"orderType": "LIMIT",
"timeInForce": "DAY",
"quantity": "10",
"executedQuantity": "4",
"leavesQuantity": "6",
"limitPrice": "150.25",
"executedPrice": "150.25",
"currency": "USD",
"createdAt": "2026-08-28T15:29:46.936Z",
"mints": [],
"burns": [],
"fees": [
{
"transactionNo": "12874152.000000",
"reference": "fee.12874152",
"amount": "0.01",
"perShare": "0.003",
"status": "BOOKED",
"chargedAt": "2026-08-28T15:30:03.112Z",
"bookedAt": "2026-08-28T15:31:01.529Z"
}
],
"feeTotal": "0.01"
}
}{
"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"
}
}{
"type": "order_updated",
"traceId": "partners-rt-gw-c3e9a11f-5b2d-4e7a-8f60-9d1c4b3e2a75",
"sentAt": "2026-09-03T20:29:15.654Z",
"payload": {
"orderId": "3402360",
"regulatoryId": "1a68ac30-3931-4261-a98e-8d0eea53ca20",
"externalRef": "ref-2026-09-03-0001",
"status": "FILLED",
"brokerStatus": "FILLED",
"side": "B",
"symbol": "AAPL",
"tokenAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"chainId": 101,
"quantity": "250",
"executedQuantity": "250",
"leavesQuantity": "0.000000",
"executedPrice": "325.13",
"currency": "USD",
"createdAt": "2026-09-03T20:29:13.737Z",
"occurredAt": "2026-09-03T20:29:15.654Z"
}
}{
"type": "trade_updated",
"traceId": "partners-rt-gw-a3c9b7ee-4d1f-4a82-b6e0-2f8c5d9a1e37",
"sentAt": "2026-09-03T20:30:01.858Z",
"payload": {
"tradeId": "12874158.000000",
"orderRegulatoryId": "1a68ac30-3931-4261-a98e-8d0eea53ca20",
"side": "B",
"symbol": "AAPL",
"tokenAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"chainId": 101,
"quantity": "50.00000000",
"grossAmount": "16256.500000",
"netAmount": "16256.500000",
"price": "325.13",
"currency": "USD",
"settled": false,
"settleDate": "2026-09-04T04:00:00.000Z",
"brokerStatus": "R",
"tradeDate": "2026-09-03T04:00:00.000Z",
"executedAt": "2026-09-03T20:29:38.487Z",
"occurredAt": "2026-09-03T20:30:01.529Z"
}
}ed25519Signature
type:asymmetricEncryption
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.
place_order
type:object
Buys or sells shares. Signed.
get_symbols
type:object
Lists the symbols you can trade, and the chains each one can be bought on.
get_redemption_address
type:object
The redemption wallet of one CET, where its tokens go before you sell the shares they stand for.
get_redemption_balance
type:object
Your own balance in one CET's redemption wallet, which your sells of that CET are checked against.
get_redemption_balances
type:object
Your own balance in the redemption wallet of every CET you can trade, in one read.
cancel_order
type:object
Requests a cancellation. Signed.
get_order
type:object
Reads where an order stands, by orderId or by externalRef.
ack (place_order)
type:object
The order was taken, refused, or never acknowledged. Not a fill.
ack (get_symbols)
type:object
One entry per symbol, sorted by symbol, each with its chains sorted by chainId.
ack (get_redemption_address)
type:object
The CET's token address and its redemption wallet on that chain.
ack (get_redemption_balance)
type:object
What you sent to the CET's redemption wallet, what of it is burned or spoken for, and what you can still sell.
ack (get_redemption_balances)
type:object
Your balance in each CET's redemption wallet, sorted by symbol and then chain.
ack (cancel_order)
type:object
The cancellation request was taken, refused, or never acknowledged.
ack (get_order)
type:object
The order as it stands, with any extra detail you asked for.
error
type:object
A request was refused. Most errors leave the socket open.
order_updated
type:object
Pushed whenever an order on the account changes.
trade_updated
type:object
Pushed once per execution, from the broker's ledger.