Hydra
Docs

Geopolitical prediction market positions and significant movements.

Prediction Markets Stream

Stream ID: markets Update frequency: 15 minutes Required tier: Basic (1,000 Hydra)

Geopolitical prediction market data — current positions, price movements, and notable shifts on active markets.

Message Types

market_update

Fired when a market's data is refreshed.

{
  "stream": "markets",
  "type": "market_update",
  "ts": 1710000000000,
  "data": {
    "id": "market-xyz",
    "question": "Will there be a ceasefire in Gaza by end of Q2 2024?",
    "category": "geopolitical",
    "tags": ["israel", "gaza", "ceasefire", "middle-east"],
    "outcomes": [
      { "name": "Yes", "price": 0.28, "priceChange24h": -0.05 },
      { "name": "No",  "price": 0.72, "priceChange24h": 0.05 }
    ],
    "volume24h": 148500,
    "liquidity": 52000,
    "resolutionDate": "2024-06-30T23:59:59Z",
    "active": true
  }
}

price_spike

Fired when a market moves significantly (>5% in 15 minutes).

{
  "stream": "markets",
  "type": "price_spike",
  "ts": 1710000000000,
  "data": {
    "id": "market-xyz",
    "question": "Will there be a ceasefire in Gaza by end of Q2 2024?",
    "outcome": "Yes",
    "previousPrice": 0.23,
    "currentPrice": 0.31,
    "changePct": 34.8,
    "volume15m": 28400
  }
}

Schema Reference

Field Type Description
id string Market identifier
question string The market question
category string Market category
tags string[] Topic tags (countries, themes)
outcomes array Each outcome with name and current price
outcomes[].price number Probability (0–1)
outcomes[].priceChange24h number 24-hour price delta
volume24h number 24-hour trading volume in USD
liquidity number Available liquidity in USD
resolutionDate string ISO 8601 resolution date
active boolean Whether market is open for trading
Tip

Combine this stream with the signals stream for correlation — when a Hydra signal fires on the same topic as a Polymarket position, there's often a tradeable edge. The Polymarket Bot implements this exact correlation logic.