Authentication summary
| Property | Value |
|---|---|
| Family | Public Realtime |
| Visibility | Public |
| Connection URL | wss://exchange.derivadex.com/realtime-api |
| Connection authentication | None currently required for the published realtime feeds |
| Subscription-control auth | None; the published contract uses feed parameters plus a client nonce, not wallet or token credentials, for control-plane requests |
| User-data scoping | Filter subscriptions by traderAddress, and optionally by strategy, symbol, or reason where supported |
| Initial account state | Retrieve from REST before relying on realtime updates |
Current public contract
The current AsyncAPI artifact publishes unauthenticated realtime endpoints. Market-data feeds are public. User-data feeds are also public, but the subscription parameters let you narrow the stream to the trader, strategy, symbol, or reason values relevant to your client. Those parameters are documented as delivery filters, not as a private ownership proof or secret credential. The current connection-control rules are:- connect directly to the realtime endpoint
- send
SUBSCRIBEorUNSUBSCRIBEmessages with a clientnonce - use the acknowledgement
noncefor correlation when it is echoed; the published subscribe and unsubscribe descriptions show matching nonces, but the payload schema only requiresresult, so keep outstanding control-request bookkeeping as fallback correlation state - bootstrap orders, strategies, and trader balances from REST before you rely on realtime updates
User-data feeds
| Feed | Primary filter surface |
|---|---|
ORDER_UPDATE | traderAddress, optional strategyIdHash, symbol, and reason |
STRATEGY_UPDATE | traderAddress, optional strategyIdHash and reason |
TRADER_UPDATE | traderAddress, optional reason |
Authority note
Historical repo-internal material describes an older token-based WebSocket flow. The current public Mintlify surface follows the current AsyncAPI contract artifacts instead.Source artifacts
- Server-side realtime AsyncAPI contract artifact in the generated realtime API package
- Client-facing realtime AsyncAPI contract artifact in the generated realtime API package