Watchlist WebSocket

Real-time WebSocket API for watchlist updates. Subscribe to receive instant notifications when symbols in your watchlist are updated, added, or removed.

What this is. A “watchlist” is a saved list of symbols a user follows — like a favorites list for the markets. This stream pushes a message whenever something on a user’s watchlist changes (a symbol is added, removed, reordered, or its name/price gets updated). Connecting your app to this stream keeps watchlists in sync across web, mobile, and any other devices the user has signed in on.

There is no separate watchlist endpoint — watchlist updates ride on the Account Updates WebSocket at wss://api.aries.com/v1/accounts/ws. Connect there, authenticate, then subscribe to the watchlist topic.

Key Features

Real-Time Modifications

Instant updates when watchlist items are added, removed, or reordered.

Symbol Notifications

Get notified when symbols in your watchlist are updated.

Cross-Device Sync

Synchronize watchlist changes across all your devices in real-time.

Bulk Updates

Efficient handling of multiple watchlist changes at once.

Watchlist Sharing

Notifications when watchlists are shared with or by you.

Change Tracking

Track all modifications with timestamps and change history.

Connection Details

Endpoint

Watchlist updates use the accounts WebSocket. Connect to the same endpoint as account updates, then subscribe to the watchlist topic:

Endpoint: wss://api.aries.com/v1/accounts/ws

See Account Updates WebSocket for connection and authentication details.

Authentication

Authentication is required. Watchlists are user-specific and require authentication to access.

Include your authentication token in the WebSocket connection headers or during the initial handshake.

Subscription Model

• Automatic subscription to your watchlists upon connection
• Receive updates for all watchlists you own or have access to
• Updates are filtered to only your accessible watchlists

Use Cases

Multi-Device Sync

Keep watchlists synchronized between mobile and web apps.

Collaborative Watchlists

Share and collaborate on watchlists with other users.

Live Updates

Display real-time watchlist changes without page refresh.

Backup and Restore

Track changes for backup and restore functionality.

Audit Trail

Maintain a history of watchlist modifications.

Notifications

Notify users when symbols are added to shared watchlists.

Under Development: This WebSocket API is currently under development. Documentation and full API specification will be available soon.