Prediction Bridge Skill

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.

Security Scan

The skill's code and runtime instructions match its stated purpose (querying a Prediction Bridge API) and do not request unrelated credentials or system access, but the service endpoint and publisher are unverified so exercise caution before sending sensitive data.

Purpose & Capability

Name/description match the bundled CLI Python client. The code implements the commands described (search, events, whale-trades, analytics, etc.) and only makes HTTP requests to the configured API; there are no unrelated capabilities (no cloud SDKs, no database or OS-level access).

Instruction Scope

SKILL.md instructs running the included Python script; the script uses only stdlib and issues GET/POST requests to the API. It does not read arbitrary local files or request other environment variables beyond an optional PREDICTION_BRIDGE_URL. Note: user queries, wallet addresses, and market IDs supplied to the CLI will be transmitted to the remote API.

Install Mechanism

There is no install spec — instruction-only with an included script. No archives or remote installers are fetched during install. Risk from install mechanism is low.

Credentials

The skill does not require credentials or special environment variables; only an optional PREDICTION_BRIDGE_URL override is documented. No unexpected secrets or unrelated env vars are requested.

Persistence & Privilege

always is false and the skill does not attempt to modify other skills or system configs. The skill can be invoked autonomously by the agent (platform default) which will cause network calls if used — this is normal but worth noting.

Assessment

This skill appears internally consistent: the script does what the README says and does not ask for credentials. However the default API host (prediction-bridge.onrender.com) and the skill owner are unverified (no homepage). Before installing or using it with sensitive input: (1) review the full script (it is included) and confirm you are comfortable with network calls to the default endpoint, (2) do not submit private keys, passwords, or other secrets through the CLI, (3) if you want more assurance, run the script against a self-hosted/trusted proxy by setting PREDICTION_BRIDGE_URL to a vetted endpoint or run it in a sandbox, and (4) prefer skills with a named publisher and homepage for production use.

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