Strade WebSocket API 1.0.0 documentation

Strade WebSocket API 1.0.0

Real-time market data and account updates over WebSocket.

Endpoint: wss://api.strade.io/ws

All messages are JSON text frames. The connection supports both public and private streams — no separate endpoints.

Message envelope

Client → Server:

{ "method": "<method>", "args": [{ ... }], "id": "req-1" }

Field	Type	Required	Description
`method`	string	✓	One of: `auth`, `subscribe`, `unsubscribe`, `ping`
`args`	array	for `auth`, `subscribe`, `unsubscribe`	Array with one or more argument objects
`id`	string	—	Client-assigned request ID, echoed verbatim in the response

Server → Client (response):

{ "id": "req-1", "result": { ... } }
{ "id": "req-1", "error": { "code": "...", "message": "..." } }

Server → Client (push):

{ "channel": "trades", "data": { ... } }
{ "channel": "orders", "data": { ... }, "sub_id": "my-sub" }

sub_id is included only when it was provided at subscribe time.

Connection limits

Parameter	Value
Max subscriptions per connection	50
Idle timeout (no pong)	60 seconds
Max inbound message size	8 KB
Max connections per user	10

The server sends WebSocket-level ping frames every ~54 seconds. If no pong is received within 60 seconds the connection is closed.

Authentication

Required once per connection before subscribing to private streams. Public streams (orderbook, trades, ticker, candles) are available immediately after connection without authentication.

Signature:

payload = timestamp + "GET" + "/api/v1/ws"
sign    = HMAC-SHA256(api_secret, payload).hexdigest

timestamp is current Unix time in milliseconds as a string.

Authentication persists for the lifetime of the connection. Re-authentication on the same connection is allowed. If the per-user connection limit (10) is reached, auth returns rate_limited and the connection stays unauthenticated.

Error codes

Returned in the error field of a response.

Code	Description
`invalid_json`	Message is not valid JSON
`unknown_method`	Unknown method name
`invalid_args`	Missing or malformed args
`invalid_channel`	Unknown channel, missing required params, or auth required for private channel
`auth_failed`	API key invalid or signature mismatch
`rate_limited`	Per-user connection limit (10) or per-connection subscription limit (50) exceeded

Servers

wss://api.strade.io/wswssproduction
Production WebSocket endpoint

Operations

PUB auth
Authenticate the connection using an HMAC-signed API key. Must be called before subscribing to private streams. Authentication persists for the lifetime of the connection.

Send auth request
Operation IDsendAuth
Available only on servers:
- production
Accepts the following message:
Authenticate Connection
object
Examples
{ "method": "auth", "id": "req-1", "args": [ { "api_key": "ak_abc123", "timestamp": "1741950000000", "sign": "a1b2c3d4e5f6..." } ] }

This example has been generated automatically.
SUB auth
Authenticate the connection using an HMAC-signed API key. Must be called before subscribing to private streams. Authentication persists for the lifetime of the connection.

Receive auth response
Operation IDsubscribe
Available only on servers:
- production
Accepts the following message:
Auth Response
oneOf
Examples
{ "id": "req-1", "result": { "status": "ok" } }

This example has been generated automatically.
PUB ping
Application-level ping. The server also sends WebSocket-level ping frames every ~54 seconds; standard WebSocket clients respond automatically.

Send ping
Operation IDsendPing
Available only on servers:
- production
Accepts the following message:
Ping
object
Examples
{ "method": "ping", "id": "req-5" }

This example has been generated automatically.
SUB ping
Application-level ping. The server also sends WebSocket-level ping frames every ~54 seconds; standard WebSocket clients respond automatically.

Receive pong
Operation IDsubscribe
Available only on servers:
- production
Accepts the following message:
Pong Response
object
Examples
{ "id": "req-5", "result": { "status": "pong" } }

This example has been generated automatically.
PUB subscribe
Subscribe to one or more channels in a single request. Processing stops at the first error — channels before the failing one are still subscribed. Re-subscribing to an already-subscribed channel is idempotent.

Subscribe to channels
Operation IDsendSubscribe
Available only on servers:
- production
Accepts the following message:
Subscribe to Channels
object
Examples
{ "method": "subscribe", "id": "req-2", "args": [ { "channel": "trades", "params": { "symbol": "BTC_USDT" } }, { "channel": "orderbook", "params": { "symbol": "BTC_USDT" } } ] }

This example has been generated automatically.
SUB subscribe
Subscribe to one or more channels in a single request. Processing stops at the first error — channels before the failing one are still subscribed. Re-subscribing to an already-subscribed channel is idempotent.

Subscription confirmation
Operation IDsubscribe
Available only on servers:
- production
Accepts the following message:
Subscribe Response
oneOf
Examples
{ "id": "req-2", "result": { "status": "subscribed", "channels": [ "trades", "orderbook" ] } }

This example has been generated automatically.

PUB unsubscribe

Unsubscribe from one or more channels.

Unsubscribe from channels

Operation IDsendUnsubscribe

Available only on servers:

production

Accepts the following message:

Unsubscribe from Channels

object

Examples

{
  "method": "unsubscribe",
  "id": "req-4",
  "args": [
    {
      "channel": "trades",
      "params": {
        "symbol": "BTC_USDT"
      }
    },
    {
      "channel": "orderbook",
      "params": {
        "symbol": "BTC_USDT"
      }
    }
  ]
}

This example has been generated automatically.

SUB unsubscribe
Unsubscribe from one or more channels.

Unsubscription confirmation
Operation IDsubscribe
Available only on servers:
- production
Accepts the following message:
Unsubscribe Response
oneOf
Examples
{ "id": "req-4", "result": { "status": "unsubscribed", "channels": [ "trades", "orderbook" ] } }

This example has been generated automatically.
PUB orderbook
Full order book snapshot pushed on every change. Bids are sorted by price descending; asks by price ascending. Each precision value is a separate subscription slot.

Subscribe to order book
Operation IDpublish
Available only on servers:
- production
object
symbolstring
required
Market symbol, e.g. BTC_USDT
Accepts the following message:
Subscribe to Order Book
object
Examples
{ "method": "subscribe", "id": "req-1", "args": [ { "channel": "orderbook", "params": { "symbol": "BTC_USDT" } } ] }

This example has been generated automatically.

SUB orderbook

Full order book snapshot pushed on every change. Bids are sorted by price descending; asks by price ascending. Each precision value is a separate subscription slot.

Receive order book snapshots

Operation IDsubscribe

Available only on servers:

production

object

symbolstring

required

Market symbol, e.g. BTC_USDT

Accepts the following message:

Order Book Push

object

Examples

{
  "channel": "orderbook",
  "data": {
    "symbol": "BTC_USDT",
    "bids": [
      {
        "price": "45000.00",
        "amount": "1.5",
        "total": "67500.00"
      },
      {
        "price": "44999.00",
        "amount": "2.3",
        "total": "103497.70"
      }
    ],
    "asks": [
      {
        "price": "45001.00",
        "amount": "0.8",
        "total": "36000.80"
      },
      {
        "price": "45002.00",
        "amount": "1.2",
        "total": "54002.40"
      }
    ],
    "timestamp": 1741950000000
  }
}

This example has been generated automatically.

PUB trades
Individual trades pushed as they occur.

Subscribe to trades
Operation IDpublish
Available only on servers:
- production
object
symbolstring
required
Market symbol, e.g. BTC_USDT
Accepts the following message:
Subscribe to Trades
object
Examples
{ "method": "subscribe", "id": "req-1", "args": [ { "channel": "trades", "params": { "symbol": "BTC_USDT" } } ] }

This example has been generated automatically.
SUB trades
Individual trades pushed as they occur.

Receive trade events
Operation IDsubscribe
Available only on servers:
- production
object
symbolstring
required
Market symbol, e.g. BTC_USDT
Accepts the following message:
Trades Push
object
Examples
{ "channel": "trades", "data": { "symbol": "BTC_USDT", "uuid": "e3b0c442-98fc-1234-b204-c9fec8a3f3d5", "price": "45000.00", "amount": "0.1", "total": "4500.00", "taker_side": "buy", "timestamp": 1741950000000 } }

This example has been generated automatically.
PUB ticker
Rolling 24-hour statistics.

Subscribe to ticker
Operation IDpublish
Available only on servers:
- production
object
symbolstring
required
Market symbol, e.g. BTC_USDT
Accepts the following message:
Subscribe to Ticker
object
Examples
{ "method": "subscribe", "id": "req-1", "args": [ { "channel": "ticker", "params": { "symbol": "BTC_USDT" } } ] }

This example has been generated automatically.

SUB ticker

Rolling 24-hour statistics.

Receive ticker updates

Operation IDsubscribe

Available only on servers:

production

object

symbolstring

required

Market symbol, e.g. BTC_USDT

Accepts the following message:

Ticker Push

object

Examples

{
  "channel": "ticker",
  "data": {
    "symbol": "BTC_USDT",
    "last_price": "45000.00",
    "open": "44000.00",
    "high": "46000.00",
    "low": "43500.00",
    "base_volume": "12345.67",
    "quote_volume": "555000000.00",
    "change": "1000.00",
    "change_percent": "2.27",
    "timestamp": 1741950000000
  }
}

This example has been generated automatically.

PUB candles
Candlestick (OHLCV) data. Each resolution value is a separate subscription slot. Both named strings and integer seconds are accepted at subscribe time ("1h" and 3600 are equivalent); push payloads always use the named string form.

Subscribe to candles
Operation IDpublish
Available only on servers:
- production
object
symbolstring
required
Market symbol, e.g. BTC_USDT

string
required
Candle resolution — "1m" (60 s), "1h" (3600 s), or "1d" (86400 s)
Accepts the following message:
Subscribe to Candles
object
Examples
{ "method": "subscribe", "id": "req-1", "args": [ { "channel": "candles", "params": { "symbol": "BTC_USDT", "resolution": "1h" } } ] }

This example has been generated automatically.
SUB candles
Candlestick (OHLCV) data. Each resolution value is a separate subscription slot. Both named strings and integer seconds are accepted at subscribe time ("1h" and 3600 are equivalent); push payloads always use the named string form.

Receive candle updates
Operation IDsubscribe
Available only on servers:
- production
object
symbolstring
required
Market symbol, e.g. BTC_USDT

string
required
Candle resolution — "1m" (60 s), "1h" (3600 s), or "1d" (86400 s)
Accepts the following message:
Candles Push
object
Examples
{ "channel": "candles", "data": { "symbol": "BTC_USDT", "resolution": "1h", "open": "44000.00", "high": "46000.00", "low": "43500.00", "close": "45000.00", "base_volume": "50.0", "quote_volume": "2250000.00", "change": "1000.00", "change_percent": "2.27", "timestamp": 1741950000000 } }

This example has been generated automatically.
PUB orders
Order status updates for the authenticated user. No parameters. Requires authentication before subscribing.

Subscribe to orders
Operation IDpublish
Available only on servers:
- production
Accepts the following message:
Subscribe to Orders
object
Examples
{ "method": "subscribe", "id": "req-1", "args": [ { "channel": "orders" } ] }

This example has been generated automatically.

SUB orders

Order status updates for the authenticated user. No parameters. Requires authentication before subscribing.

Receive order updates

Operation IDsubscribe

Available only on servers:

production

Accepts the following message:

Orders Push

object

Examples

{
  "channel": "orders",
  "data": {
    "event": "order_filled",
    "timestamp": 1741950000000,
    "order": {
      "uuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
      "symbol": "BTC_USDT",
      "side": "buy",
      "type": "limit",
      "status": "filled",
      "price": "45000.00",
      "stop_price": null,
      "amount": "0.1",
      "initial_amount": "0.1",
      "filled_amount": "0.1",
      "total": "4500.00",
      "initial_total": "4500.00",
      "filled_total": "4500.00",
      "time_in_force": "GTC",
      "created_at": "2026-03-28T10:00:00Z",
      "updated_at": "2026-03-28T10:00:05Z",
      "opened_at": "2026-03-28T10:00:00Z",
      "triggered_at": null
    }
  }
}

This example has been generated automatically.

PUB balances
Balance updates for all assets of the authenticated user. No parameters. Requires authentication before subscribing.

Subscribe to balances
Operation IDpublish
Available only on servers:
- production
Accepts the following message:
Subscribe to Balances
object
Examples
{ "method": "subscribe", "id": "req-1", "args": [ { "channel": "balances" } ] }

This example has been generated automatically.

SUB balances

Balance updates for all assets of the authenticated user. No parameters. Requires authentication before subscribing.

Receive balance updates

Operation IDsubscribe

Available only on servers:

production

Accepts the following message:

Balances Push

object

Examples

{
  "channel": "balances",
  "data": {
    "event": "balance_updated",
    "timestamp": 1741950000000,
    "balance": {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "asset": "BTC",
      "balance": "1.5",
      "frozen": "0.5",
      "available": "1.0"
    }
  }
}

This example has been generated automatically.

PUB deposits
Deposit events for the authenticated user. No parameters. Requires authentication before subscribing. payment.type values on this channel: deposit, internal_deposit.

Subscribe to deposits
Operation IDpublish
Available only on servers:
- production
Accepts the following message:
Subscribe to Deposits
object
Examples
{ "method": "subscribe", "id": "req-1", "args": [ { "channel": "deposits" } ] }

This example has been generated automatically.

SUB deposits

Deposit events for the authenticated user. No parameters. Requires authentication before subscribing. payment.type values on this channel: deposit, internal_deposit.

Receive deposit events

Operation IDsubscribe

Available only on servers:

production

Accepts the following message:

Deposits Push

object

Examples

{
  "channel": "deposits",
  "data": {
    "event": "payment_processed",
    "timestamp": 1741950000000,
    "payment": {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "asset": "BTC",
      "network": "bitcoin",
      "amount": "0.01",
      "status": "processed",
      "tx_hash": "abc123...",
      "source": "bc1q...",
      "destination": "bc1q...",
      "memo": null,
      "type": "deposit",
      "created_at": "2026-03-28T10:00:00Z",
      "updated_at": "2026-03-28T10:05:00Z"
    }
  }
}

This example has been generated automatically.

PUB withdrawals
Withdrawal events for the authenticated user. No parameters. Requires authentication before subscribing. payment.type values on this channel: withdrawal, internal_withdrawal.

Subscribe to withdrawals
Operation IDpublish
Available only on servers:
- production
Accepts the following message:
Subscribe to Withdrawals
object
Examples
{ "method": "subscribe", "id": "req-1", "args": [ { "channel": "withdrawals" } ] }

This example has been generated automatically.

SUB withdrawals

Withdrawal events for the authenticated user. No parameters. Requires authentication before subscribing. payment.type values on this channel: withdrawal, internal_withdrawal.

Receive withdrawal events

Operation IDsubscribe

Available only on servers:

production

Accepts the following message:

Withdrawals Push

object

Examples

{
  "channel": "withdrawals",
  "data": {
    "event": "payment_processed",
    "timestamp": 1741950000000,
    "payment": {
      "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "asset": "USDT",
      "network": "ethereum",
      "amount": "500.00",
      "status": "processed",
      "tx_hash": "0xabc123...",
      "source": "0x1234...",
      "destination": "0x5678...",
      "memo": null,
      "type": "withdrawal",
      "created_at": "2026-03-28T10:00:00Z",
      "updated_at": "2026-03-28T10:05:00Z"
    }
  }
}

This example has been generated automatically.

PUB transfers
Internal transfer events for the authenticated user. No parameters. Requires authentication before subscribing.

Subscribe to transfers
Operation IDpublish
Available only on servers:
- production
Accepts the following message:
Subscribe to Transfers
object
Examples
{ "method": "subscribe", "id": "req-1", "args": [ { "channel": "transfers" } ] }

This example has been generated automatically.

SUB transfers

Internal transfer events for the authenticated user. No parameters. Requires authentication before subscribing.

Receive transfer events

Operation IDsubscribe

Available only on servers:

production

Accepts the following message:

Transfers Push

object

Examples

{
  "channel": "transfers",
  "data": {
    "event": "transfer_processed",
    "timestamp": 1741950000000,
    "transfer": {
      "uuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "asset": "USDT",
      "from_user_uuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
      "from_account": "main",
      "to_user_uuid": "e5f6a7b8-c9d0-1234-efab-234567890123",
      "to_account": "sub",
      "amount": "100.00",
      "status": "processed",
      "created_at": "2026-03-28T10:00:00Z"
    }
  }
}

This example has been generated automatically.

Messages

#1Authenticate Connection
Message IDAuthRequest
object
#2Ping
Message IDPingRequest
object
#3Subscribe to Channels
Message IDSubscribeRequest
object
#4Unsubscribe from Channels
Message IDUnsubscribeRequest
object
#5Subscribe to Order Book
Message IDSubscribeOrderbook
object
#6Subscribe to Trades
Message IDSubscribeTrades
object
#7Subscribe to Ticker
Message IDSubscribeTicker
object
#8Subscribe to Candles
Message IDSubscribeCandles
object
#9Subscribe to Orders
Message IDSubscribeOrders
object
#10Subscribe to Balances
Message IDSubscribeBalances
object
#11Subscribe to Deposits
Message IDSubscribeDeposits
object
#12Subscribe to Withdrawals
Message IDSubscribeWithdrawals
object
#13Subscribe to Transfers
Message IDSubscribeTransfers
object
#14Auth Response
Message IDAuthResponse
oneOf
#15Pong Response
Message IDPingResponse
object
#16Subscribe Response
Message IDSubscribeResponse
oneOf
#17Unsubscribe Response
Message IDUnsubscribeResponse
oneOf
#18Error Response
Message IDErrorResponse
object
#19Order Book Push
Message IDOrderbookPush
object
#20Trades Push
Message IDTradesPush
object
#21Ticker Push
Message IDTickerPush
object
#22Candles Push
Message IDCandlesPush
object
#23Orders Push
Message IDOrdersPush
object
#24Balances Push
Message IDBalancesPush
object
#25Deposits Push
Message IDDepositsPush
object
#26Withdrawals Push
Message IDWithdrawalsPush
object
#27Transfers Push
Message IDTransfersPush
object

Schemas

object
object
object
object
object

Strade WebSocket API 1.0.0

Message envelope

Connection limits

Authentication

Error codes

Servers

Operations

PUB auth

Examples

This example has been generated automatically.

SUB auth

Examples

This example has been generated automatically.

PUB ping

Examples

This example has been generated automatically.

SUB ping

Examples

This example has been generated automatically.

PUB subscribe

Examples

This example has been generated automatically.

SUB subscribe

Examples

This example has been generated automatically.

PUB unsubscribe

Examples

This example has been generated automatically.

SUB unsubscribe

Examples

This example has been generated automatically.

PUB orderbook

Examples

This example has been generated automatically.

SUB orderbook

Examples

This example has been generated automatically.

PUB trades

Examples

This example has been generated automatically.

SUB trades

Examples

This example has been generated automatically.

PUB ticker

Examples

This example has been generated automatically.

SUB ticker

Examples

This example has been generated automatically.

PUB candles

Examples

This example has been generated automatically.

SUB candles

Examples

This example has been generated automatically.

PUB orders

Examples

This example has been generated automatically.

SUB orders

Examples

This example has been generated automatically.

PUB balances

Examples

This example has been generated automatically.

SUB balances

Examples

This example has been generated automatically.

PUB deposits

Examples

This example has been generated automatically.

SUB deposits

Examples

This example has been generated automatically.

PUB withdrawals

Examples

This example has been generated automatically.

SUB withdrawals

Examples

This example has been generated automatically.

PUB transfers