WebSocket Reference
monitor:signals
News signals and AI predictions stream
The monitor:signals channel broadcasts real-time signals from the news ingestion pipeline and market-data-based signal detection. Signals include breaking news, whale trades, momentum shifts, and geopolitical events, each linked to relevant prediction markets.
Subscribe
{ "event": "subscribe", "data": { "channel": "monitor:signals" } }Unsubscribe
{ "event": "unsubscribe", "data": { "channel": "monitor:signals" } }Server Broadcast
{
"channel": "monitor:signals",
"data": {
"id": "e1f2a3b4-c5d6-7890-ef12-345678abcdef",
"type": "geopolitical",
"severity": "critical",
"headline": "EU announces new crypto regulation framework",
"summary": "The European Commission published a comprehensive regulatory framework for digital assets, expected to impact DeFi protocols and prediction markets operating in the EU.",
"source": "news",
"sourceName": "Reuters",
"sourceHandle": null,
"category": "crypto",
"lat": 50.8503,
"lng": 4.3517,
"country": "Belgium",
"countryCode": "BE",
"countryFlag": "🇧🇪",
"address": null,
"marketId": "c5a2e7f1-3b4d-4e6a-8f9c-1d2e3f4a5b6c",
"side": null,
"amount": null,
"relatedMarketIds": [
"d6e7f8a9-b0c1-2345-6789-abcdef012345",
"f8a9b0c1-d2e3-4567-890a-bcdef0123456"
],
"imageUrl": "https://example.com/article-image.jpg",
"sourceUrl": "https://reuters.com/article/eu-crypto-regulation",
"sourceAvatarUrl": null,
"createdAt": "2026-03-27T14:25:00.000Z"
}
}Payload Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique signal identifier (UUID) |
type | string | whale_trade, momentum_shift, anomaly, geopolitical |
severity | string | critical, high, low |
headline | string | Short signal headline |
summary | string | Detailed description of the signal |
source | string | Signal source: platform, x, telegram, news |
sourceName | string | Name of the source (e.g., Reuters, Vezta) |
sourceHandle | string? | Social media handle (for X/Telegram sources) |
category | string | politics, military, financials, crypto, tech, energy, macro |
lat | number? | Latitude for globe visualization |
lng | number? | Longitude for globe visualization |
country | string? | Country name |
countryCode | string? | ISO 3166-1 alpha-2 country code |
countryFlag | string? | Country flag emoji |
address | string? | Wallet address (for whale trade signals) |
marketId | string? | Primary linked market ID |
side | string? | Trade side: yes or no (for whale trade signals) |
amount | string? | Trade amount in USD (for whale trade signals) |
relatedMarketIds | string[] | Additional markets affected by this signal |
imageUrl | string? | Article or signal image URL |
sourceUrl | string? | Link to the original article or post |
sourceAvatarUrl | string? | Author profile picture URL |
createdAt | string | ISO 8601 timestamp |
Signal Types
| Type | Description | Typical Sources |
|---|---|---|
whale_trade | Large trade detected from a notable wallet | Platform (on-chain data) |
momentum_shift | Significant price or volume movement pattern | Platform (market data) |
anomaly | Unusual trading activity or market behavior | Platform (signal detector) |
geopolitical | News event with potential market impact | GDELT, RSS, NewsData, X, Telegram |
Notes
- This channel does not require authentication -- signals are public
- Signals arrive as they are processed through the ingestion pipeline (see Signal Pipeline)
- Frequency varies by source: RSS every 5min, GDELT every 30min, NewsData every 15min, CryptoNews every 10min, Telegram every 15min, X every 60min
- Geographic coordinates (
lat/lng) are available for geopolitical signals and power the 3D globe on the monitor page - Whale trade signals include
address,side, andamountfields; news signals typically have these asnull