Monitor

The Monitor API provides access to the signal detection and AI prediction systems. Signals are generated by ingesting news from multiple sources and linking them to relevant prediction markets. AI predictions provide model-generated probability estimates for markets. All monitor endpoints are public.

Signal Endpoints

Method	Path	Auth	Description
GET	`/api/v1/monitor/signals`	Public	Get monitor signals feed
GET	`/api/v1/monitor/stats`	Public	Get monitor statistics

AI Prediction Endpoints

Method	Path	Auth	Description
GET	`/api/v1/ai-predictions`	Public	Get AI predictions list
GET	`/api/v1/ai-predictions/stats`	Public	Get AI model statistics
GET	`/api/v1/ai-predictions/:id`	Public	Get AI prediction detail

Get Signals

Fetch the signal feed with optional filters for type, severity, category, and minimum trade amount.

Query Parameters:

Parameter	Type	Default	Description
`type`	string	--	Signal type: `whale_trade`, `momentum_shift`, `anomaly`
`severity`	string	--	Severity level: `critical`, `high`, `low`
`category`	string	--	Market category: `politics`, `military`, `financials`, `crypto`, `tech`, `energy`, `macro`
`minAmount`	number	--	Minimum trade amount in USD
`limit`	number	20	Number of results (1-500)
`cursor`	string	--	Cursor for pagination

// GET /api/v1/monitor/signals?severity=critical&category=politics&limit=5

// Response 200
{
  "signals": [
    {
      "id": "signal-uuid-123",
      "type": "momentum_shift",
      "severity": "critical",
      "title": "Major policy announcement impacts election markets",
      "summary": "Breaking news linked to 3 active prediction markets...",
      "category": "politics",
      "source": "gdelt",
      "linkedMarkets": [
        {
          "marketId": "mkt-uuid-456",
          "title": "Will the incumbent win?",
          "priceImpact": 0.08
        }
      ],
      "publishedAt": "2026-03-27T13:45:00.000Z"
    }
  ],
  "nextCursor": "eyJpZCI6ImFiYzEyMyJ9"
}

Monitor Stats

Get aggregate statistics about the signal ingestion pipeline.

// GET /api/v1/monitor/stats

// Response 200
{
  "totalSignals": 12450,
  "signalsToday": 87,
  "sourceCounts": {
    "gdelt": 4200,
    "rss": 3100,
    "newsdata": 2800,
    "cryptonews": 1500,
    "telegram": 600,
    "x": 250
  },
  "avgSignalsPerDay": 120
}

AI Predictions

Get AI-generated probability predictions for markets. The AI models analyze market data, news signals, and historical patterns to generate predictions.

// GET /api/v1/ai-predictions

// Response 200
{
  "predictions": [
    {
      "id": "pred-uuid-789",
      "marketId": "mkt-uuid-456",
      "marketTitle": "Will the Fed cut rates in June 2026?",
      "predictedProbability": 0.71,
      "currentPrice": 0.63,
      "confidence": 0.85,
      "direction": "bullish",
      "reasoning": "Recent economic indicators and Fed commentary suggest...",
      "createdAt": "2026-03-27T12:00:00.000Z"
    }
  ]
}

AI Model Stats

Get performance statistics for the AI prediction models, including accuracy metrics and historical performance.

// GET /api/v1/ai-predictions/stats

// Response 200
{
  "totalPredictions": 3200,
  "accuracy": 0.68,
  "avgConfidence": 0.72,
  "profitablePredictions": 2176,
  "modelVersion": "v2.1"
}

Signal Sources

The signal ingestion pipeline collects data from six sources on different schedules:

Source	Frequency	Description
RSS	Every 5 min	RSS feeds from major news outlets
GDELT	Every 30 min	Global event database
NewsData	Every 15 min	Multi-category news API (staggered by category)
CryptoNews	Every 10 min	Cryptocurrency-specific news
Telegram	Every 15 min	Telegram channel monitoring
X (Twitter)	Every 60 min	Social media signal detection

Notes

Signals are also broadcast in real-time via the monitor:signals WebSocket channel
The ingestion pipeline deduplicates signals, links them to relevant markets, and adds geo-tagging
AI predictions compare their predictedProbability against the current market price to determine direction (bullish if prediction > price, bearish otherwise)
Signal categories align with market categories for easy cross-referencing

On this page