Prediction Bridge

Query live prediction market data across 9+ platforms via the Prediction Bridge API.

How to Use

Run the script at scripts/prediction_bridge.py with the appropriate command. It uses only Python stdlib — no pip install needed.

python scripts/prediction_bridge.py <command> [args] [options]

Commands

Search events by meaning

python scripts/prediction_bridge.py search "trump tariff" --limit 5
python scripts/prediction_bridge.py search "will bitcoin hit 100k"
python scripts/prediction_bridge.py search "2028 election" --include-inactive

Browse events

python scripts/prediction_bridge.py events --limit 10
python scripts/prediction_bridge.py events --source polymarket --limit 5
python scripts/prediction_bridge.py events --status active --category "Crypto"
python scripts/prediction_bridge.py event 1839                          # detail by ID

News matched to events

python scripts/prediction_bridge.py news --limit 10

Platform statistics

python scripts/prediction_bridge.py stats

Whale trades (on-chain large trades)

python scripts/prediction_bridge.py whale-trades --limit 10
python scripts/prediction_bridge.py whale-trades --address 0x1234...    # by wallet
python scripts/prediction_bridge.py whale-trades --min-value 50000      # min USD
python scripts/prediction_bridge.py whale-trades --only-alerts          # above alert threshold
python scripts/prediction_bridge.py whale-trades --event-slug "us-election"

Market price data

python scripts/prediction_bridge.py market-history polymarket 18454
python scripts/prediction_bridge.py market-candles polymarket 18454 --interval 1h

Analytics

python scripts/prediction_bridge.py smart-pnl 18454                    # market Smart PnL
python scripts/prediction_bridge.py top-holders 18454                   # top holders breakdown
python scripts/prediction_bridge.py leaderboard --limit 20              # top traders
python scripts/prediction_bridge.py user-summary 0x1234...              # wallet portfolio
python scripts/prediction_bridge.py user-pnl 0x1234...                  # realized PnL

Other

python scripts/prediction_bridge.py languages                           # supported languages
python scripts/prediction_bridge.py --help                              # full help

Typical Workflows

"What are the hottest prediction markets right now?" → events --limit 10 (sorted by volume)

"Find markets about AI regulation" → search "AI regulation" (semantic search)

"Show me recent whale trades on Polymarket" → whale-trades --limit 10

"Who are the top traders and what are they betting on?" → leaderboard --limit 10, then user-summary <address> for details

"What's the Smart PnL signal for a specific market?" → Get market ID from event <id>, then smart-pnl <market_id>

"Any news moving prediction markets today?" → news --limit 10

Environment

Set PREDICTION_BRIDGE_URL to override the default API base URL:

export PREDICTION_BRIDGE_URL=https://prediction-bridge.onrender.com