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

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