Get your free API key at dashboard.predexon.com - required for WebSocket connections.
Use Cases
Copytrading
Subscribe to top traders’ wallets and get instant notifications when they make trades to mirror their positions.
Market Monitoring
Track specific markets for price movements and trading activity in real-time.
Portfolio Alerts
Monitor your own wallet or watchlist for trade confirmations and activity.
Analytics & Research
Stream all trades (Pro) to build datasets, analyze market dynamics, and identify trends.
Quick Start
Connection
Endpoint
Connection Response
On successful connection:Idle Timeout
Connections with no active subscriptions are closed after 120 seconds. Subscribe to at least one filter to keep the connection alive.Plans & Limits
| Feature | Free | Pro |
|---|---|---|
| Subscriptions | 2 | 100 |
| Items per subscription | 5 | 500 |
| Total items | 10 | 50,000 |
| Wildcard (all trades) | No | Yes |
Wildcard Subscription (Pro only)
Pro users can subscribe to all trades across the entire platform using the wildcard subscription. This is ideal for building comprehensive datasets, real-time analytics dashboards, or monitoring market-wide activity. Wildcard rules:- Wildcard must be the only subscription on the connection
- Wildcard allows only one active connection per API key
- Cannot add other subscriptions while wildcard is active
Error Handling
All errors follow this format:Error Codes
| Code | Description |
|---|---|
INVALID_API_KEY | API key not found or invalid |
INVALID_FILTERS | Missing or malformed filters |
SUBSCRIPTION_LIMIT | Maximum subscriptions reached |
ITEMS_LIMIT | Maximum total items reached |
ITEMS_PER_SUB_LIMIT | Too many items in single subscription |
WILDCARD_NOT_ALLOWED | Wildcard requires Pro plan |
WILDCARD_CONNECTION_LIMIT | Wildcard allows only one connection |
CONNECTION_LIMIT | Too many connections for this API key |
SUBSCRIPTION_NOT_FOUND | Subscription ID doesn’t exist |
Close Codes
| Code | Reason |
|---|---|
1000 | Normal closure |
1001 | Server shutting down |
1006 | Abnormal closure (network issue) |
4000 | Idle timeout (no subscriptions for 120s) |
4001 | Authentication failed |
4002 | Limit exceeded |
Best Practices
Reconnect with backoff
Implement exponential backoff when reconnecting after disconnects
Subscribe quickly
Send your first subscription within 120s to avoid idle timeout
Batch items
Combine multiple items in one subscription when possible
Handle errors gracefully
Check error codes and adjust subscriptions accordingly
