WebSocket Overview

Senticore WebSocket streams provide real-time market data, account events, fills, risk updates, and protocol transparency messages.

Stream families

Family	Endpoint	Auth	Best for
Public streams	wss://stream.beta.sentico-labs.xyz/public	None	Orderbooks, trades, tickers, status
Private streams	wss://stream.beta.sentico-labs.xyz/private	Required	Fills, balances, positions, order state

Both stream families use the same envelope, sequence model, heartbeat, and resync behavior.

Design goals

• Monotonic sequencing per channel and market
• Explicit gap detection through seq and prevSeq
• Snapshot-plus-delta recovery for orderbooks
• Multiplexed subscriptions on one TLS connection
• Stable schema identifiers for forward compatibility

Client responsibilities

Production stream clients should:

• verify sequence continuity for every subscribed stream
• resync from REST snapshots after gaps or checksum mismatches
• respond to heartbeat pings within the deadline
• use exponential reconnect backoff with jitter
• separate public data recovery from private account recovery

Next

• WebSocket protocol
• Public channels
• Private channels
• Reconnect strategy