prediction-bridge

name

prediction-bridge

description

Query live prediction market data from the Prediction Bridge API. Use when the user asks about prediction markets, event odds, market prices, whale trades, trader analytics, or news related to prediction markets. Provides semantic search across 9+ platforms (Polymarket, Kalshi, Limitless, Probable, PredictFun, SxBet, Myriad, PancakeSwap), on-chain whale trade monitoring, Smart PnL analytics, and trader leaderboards. Run the bundled Python script to fetch real-time data.

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