Messages
{
"type": "get_cash_balance_v2",
"requestId": "7c2e9a41b5d84f06a3e1c8b27d5f0e93"
}{
"type": "get_cash_movements",
"requestId": "1f6d3b8e2a9c4057b1e4d7a0c3f62b85",
"payload": {
"limit": 10
}
}{
"type": "get_crypto_funding",
"requestId": "3b9e1c7a5d2f4e86a0c4b8d1f6e2a957"
}{
"type": "submit_crypto_funding",
"requestId": "8d4f2a6c1e9b4073b5a2c7e0d3f8b164",
"timestamp": 1793631600,
"payload": {
"chainId": 1952,
"txHash": "0xabab5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6071829"
},
"signature": "3Kf9…"
}{
"type": "cash_movement",
"traceId": "partners-rt-gw-0b7e4c19-5a2d-4f83-b6e1-9c3d8a2f7e54",
"sentAt": "2026-10-24T16:21:14.420Z",
"payload": {
"eventId": "742352b766ba4c2710207aae:BOOKED:1693600582c5aebc9499c1d7",
"id": "742352b766ba4c2710207aae",
"type": "DEPOSIT",
"amount": "1.000000",
"currency": "USD",
"status": "BOOKED",
"bookedAt": "2026-10-24T16:21:13.170Z"
}
}{
"type": "ack",
"for": "get_cash_balance_v2",
"requestId": "7c2e9a41b5d84f06a3e1c8b27d5f0e93",
"traceId": "partners-rt-gw-3e8b1c52-7d4a-4f96-a0e2-5b9c6d1f8a37",
"sentAt": "2026-10-25T13:03:10.215Z",
"payload": {
"balances": [
{
"currency": "USD",
"deposited": "1000",
"withdrawn": "0.5",
"fees": "0.3",
"bought": "500",
"sold": "0",
"netBalance": "499.2",
"committed": "100.1",
"available": "399.1"
}
]
}
}{
"type": "ack",
"for": "get_cash_movements",
"requestId": "1f6d3b8e2a9c4057b1e4d7a0c3f62b85",
"traceId": "partners-rt-gw-6a1f2d94-8b3e-4c57-9e0a-2d7b5c4f1e86",
"sentAt": "2026-10-25T13:04:11.002Z",
"payload": {
"movements": [
{
"id": "742352b766ba4c2710207aae",
"type": "DEPOSIT",
"amount": "1.000000",
"currency": "USD",
"status": "BOOKED",
"bookedAt": "2026-10-24T16:21:13.170Z"
}
]
}
}{
"type": "ack",
"for": "get_crypto_funding",
"requestId": "3b9e1c7a5d2f4e86a0c4b8d1f6e2a957",
"traceId": "partners-rt-gw-5c2a8e17-4b9d-4f30-a6e1-8d3f7b2c9e05",
"sentAt": "2026-11-03T14:58:02.117Z",
"payload": {
"enabled": true,
"depositTo": [
{
"chainId": 1952,
"token": "USDC",
"tokenAddress": "0x1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d",
"address": "0x8f3c6a1e9b2d4c7f0a5e3b8d1c6f9a2e4b7d0c35",
"decimals": 6,
"minConfirmations": 12
}
],
"fromWallets": [
{
"namespace": "eip155",
"address": "0x1111aaaa2222bbbb3333cccc4444dddd5555eeee"
}
]
}
}{
"type": "ack",
"for": "submit_crypto_funding",
"requestId": "8d4f2a6c1e9b4073b5a2c7e0d3f8b164",
"traceId": "partners-rt-gw-9e1b4d7c-3a6f-4c82-b5d0-2f8e6a1c7b39",
"sentAt": "2026-11-03T15:00:00.412Z",
"payload": {
"status": "CREDITED",
"movementId": "6ae9a0c1d2e4b5a6978c0d1e",
"amount": "250.5",
"currency": "USD",
"chainId": 1952,
"txHash": "0xabab5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6071829",
"bookedAt": "2026-11-03T15:00:00.000Z"
}
}{
"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"
}
}API reference
Cash
Read your own cash and its movements, and fund it with USDC.
WSS
/
v1
/
market-maker
/
stream
A buy is checked against the
available of get_cash_balance_v2, your own cash. See Cash for what each figure means, and Fund your cash with crypto for the steps of a crypto deposit.Messages
{
"type": "get_cash_balance_v2",
"requestId": "7c2e9a41b5d84f06a3e1c8b27d5f0e93"
}{
"type": "get_cash_movements",
"requestId": "1f6d3b8e2a9c4057b1e4d7a0c3f62b85",
"payload": {
"limit": 10
}
}{
"type": "get_crypto_funding",
"requestId": "3b9e1c7a5d2f4e86a0c4b8d1f6e2a957"
}{
"type": "submit_crypto_funding",
"requestId": "8d4f2a6c1e9b4073b5a2c7e0d3f8b164",
"timestamp": 1793631600,
"payload": {
"chainId": 1952,
"txHash": "0xabab5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6071829"
},
"signature": "3Kf9…"
}{
"type": "cash_movement",
"traceId": "partners-rt-gw-0b7e4c19-5a2d-4f83-b6e1-9c3d8a2f7e54",
"sentAt": "2026-10-24T16:21:14.420Z",
"payload": {
"eventId": "742352b766ba4c2710207aae:BOOKED:1693600582c5aebc9499c1d7",
"id": "742352b766ba4c2710207aae",
"type": "DEPOSIT",
"amount": "1.000000",
"currency": "USD",
"status": "BOOKED",
"bookedAt": "2026-10-24T16:21:13.170Z"
}
}{
"type": "ack",
"for": "get_cash_balance_v2",
"requestId": "7c2e9a41b5d84f06a3e1c8b27d5f0e93",
"traceId": "partners-rt-gw-3e8b1c52-7d4a-4f96-a0e2-5b9c6d1f8a37",
"sentAt": "2026-10-25T13:03:10.215Z",
"payload": {
"balances": [
{
"currency": "USD",
"deposited": "1000",
"withdrawn": "0.5",
"fees": "0.3",
"bought": "500",
"sold": "0",
"netBalance": "499.2",
"committed": "100.1",
"available": "399.1"
}
]
}
}{
"type": "ack",
"for": "get_cash_movements",
"requestId": "1f6d3b8e2a9c4057b1e4d7a0c3f62b85",
"traceId": "partners-rt-gw-6a1f2d94-8b3e-4c57-9e0a-2d7b5c4f1e86",
"sentAt": "2026-10-25T13:04:11.002Z",
"payload": {
"movements": [
{
"id": "742352b766ba4c2710207aae",
"type": "DEPOSIT",
"amount": "1.000000",
"currency": "USD",
"status": "BOOKED",
"bookedAt": "2026-10-24T16:21:13.170Z"
}
]
}
}{
"type": "ack",
"for": "get_crypto_funding",
"requestId": "3b9e1c7a5d2f4e86a0c4b8d1f6e2a957",
"traceId": "partners-rt-gw-5c2a8e17-4b9d-4f30-a6e1-8d3f7b2c9e05",
"sentAt": "2026-11-03T14:58:02.117Z",
"payload": {
"enabled": true,
"depositTo": [
{
"chainId": 1952,
"token": "USDC",
"tokenAddress": "0x1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d",
"address": "0x8f3c6a1e9b2d4c7f0a5e3b8d1c6f9a2e4b7d0c35",
"decimals": 6,
"minConfirmations": 12
}
],
"fromWallets": [
{
"namespace": "eip155",
"address": "0x1111aaaa2222bbbb3333cccc4444dddd5555eeee"
}
]
}
}{
"type": "ack",
"for": "submit_crypto_funding",
"requestId": "8d4f2a6c1e9b4073b5a2c7e0d3f8b164",
"traceId": "partners-rt-gw-9e1b4d7c-3a6f-4c82-b5d0-2f8e6a1c7b39",
"sentAt": "2026-11-03T15:00:00.412Z",
"payload": {
"status": "CREDITED",
"movementId": "6ae9a0c1d2e4b5a6978c0d1e",
"amount": "250.5",
"currency": "USD",
"chainId": 1952,
"txHash": "0xabab5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6071829",
"bookedAt": "2026-11-03T15:00:00.000Z"
}
}{
"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"
}
}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.
get_cash_balance_v2
type:object
Reads your own cash, per currency.
get_cash_movements
type:object
Reads the movements behind your own cash balance, newest first.
get_crypto_funding
type:object
Reads where to send USDC to fund your own cash, and the wallets it must come from.
submit_crypto_funding
type:object
Credits a USDC deposit you already sent to your own cash, by its transaction hash. Signed.
cash_movement
type:object
Pushed when a movement of your own cash changes.
ack (get_cash_balance_v2)
type:object
Your own cash, one entry per currency.
ack (get_cash_movements)
type:object
One page of your cash movements.
ack (get_crypto_funding)
type:object
Where to send USDC, and the wallets it must come from.
ack (submit_crypto_funding)
type:object
The deposit is credited to your own cash.
error
type:object
A request was refused. Most errors leave the socket open.