modbender 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