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.