prediction-markets

Prediction Markets (Predexon)

58 endpoints across Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow, Binance Futures, sports, and the UMA oracle — one x402 gateway, no Predexon account or API key.

What is worth paying for. Current market lists are free from public APIs. These are not, and cannot be backfilled after the fact:

• History — candlesticks, orderbook snapshots, volume charts, open interest, trade history. Built from continuous ingestion; nobody can reconstruct it retroactively.
• Smart money — leaderboards, cohort stats, top holders, which wallets are positioned where, and which markets high-performing wallets just entered.
• Wallet intelligence — profiles, P&L time series, identity metadata, and on-chain clustering (find the other wallets behind one address).
• Cross-venue canonical IDs — one question, matched across five venues. The basis for arbitrage and consensus.

How to Call from MCP

One tool, three params. Method auto-routes: POST when body is set, GET otherwise.

blockrun_markets({ path: "polymarket/events", params: { limit: "10" } })

blockrun_markets({ path: "polymarket/candlesticks/0xCONDITION_ID", params: { interval: "1h" } })

blockrun_markets({ path: "polymarket/wallet/identities", body: {
  addresses: ["0xabc...", "0xdef..."]
}})

Paths are relative — no /api/v1/pm/ prefix. Use agent_id to bill a child agent's budget.

Two Pricing Tiers

Pass-through pricing, 0% BlockRun margin — settles straight to Predexon's Base treasury.

Quick Decision Table — "User asks about X"

Worked Examples

1. "What are people betting on right now?"

blockrun_markets({ path: "polymarket/events", params: { limit: "10" } })

2. "What's the market saying about the 2028 election?"

Search every venue in one call, then resolve the canonical outcome.

blockrun_markets({ path: "markets/search", params: { q: "2028 presidential election" } })
blockrun_markets({ path: "outcomes/PXM-12345" })   // → venue listings + prices side by side

3. "Show me this market's price history" (impossible from a free API)

blockrun_markets({ path: "polymarket/candlesticks/0xCONDITION_ID", params: { interval: "1h" } })
blockrun_markets({ path: "polymarket/volume-chart/0xCONDITION_ID" })
blockrun_markets({ path: "polymarket/markets/0xCONDITION_ID/open_interest" })

4. "Who's smart money betting on in this market?" ← compound

Positioning → then profile the wallets behind it.

// 1. Which high-performing wallets are in this market, and on which side
blockrun_markets({ path: "polymarket/market/0xCONDITION_ID/smart-money" })

// 2. Profile the top wallet it returns — win rate, P&L, style
blockrun_markets({ path: "polymarket/wallet/0xWHALE" })

// 3. What else are they in right now?
blockrun_markets({ path: "polymarket/wallet/positions/0xWHALE" })

5. "This whale is up 400% — who are they really?" ← compound

Identity plus the on-chain cluster: one trader often runs many wallets.

blockrun_markets({ path: "polymarket/wallet/identity/0xWHALE" })        // ENS, socials, portfolio
blockrun_markets({ path: "polymarket/wallet/0xWHALE/cluster" })         // linked wallets + confidence
blockrun_markets({ path: "polymarket/wallet/pnl/0xWHALE" })             // realized P&L series
blockrun_markets({ path: "polymarket/wallet/0xWHALE/similar" })         // who trades like them

6. "Find me something to copy-trade" ← compound

blockrun_markets({ path: "polymarket/leaderboard", params: { limit: "20" } })   // best wallets
blockrun_markets({ path: "polymarket/markets/smart-activity" })                 // where they just moved
blockrun_markets({ path: "polymarket/cohorts/stats" })                          // which style is working

Then trade it with blockrun_polymarket (see skills/polymarket-trading/SKILL.md). Real money — always dry-run first.

7. "Is the same bet cheaper on another venue?" ← arbitrage

blockrun_markets({ path: "matching-markets", params: { status: "active" } })
blockrun_markets({ path: "matching-markets/pairs" })

8. "Who's ahead in tonight's NBA games?"

blockrun_markets({ path: "sports/markets", params: { league: "NBA", status: "open" } })
blockrun_markets({ path: "sports/markets/GAME_ID" })   // every venue's price for that game

9. "Is this market about to resolve?"

blockrun_markets({ path: "polymarket/uma/markets", params: { state: "proposed" } })
blockrun_markets({ path: "polymarket/uma/market/0xCONDITION_ID" })   // dispute timeline

Method Routing — When to Use body

Almost everything is GET → use params. Only bulk identity takes a body:

blockrun_markets({ path: "polymarket/wallet/identities", body: { addresses: ["0x1", "0x2"] } })

Paging Large Result Sets

Prefer keyset over offset — stable across writes, faster on big tables.

const p1 = blockrun_markets({ path: "polymarket/markets/keyset", params: { limit: "100" } })
// then pass the returned pagination.next_key back in:
blockrun_markets({ path: "polymarket/markets/keyset", params: { limit: "100", pagination_key: "<next_key>" } })

polymarket/events/keyset works the same way.

Notes on Response Shape

Predexon returns raw upstream responses; shape varies by venue.

• Polymarket — usually { data: [...] } or { events: [...] }
• Kalshi — usually { markets: [...] } with ticker, yes_bid, no_bid. Tickers look like KXBTC-25MAR14 (series + expiry).
• Canonical v2 — { markets: [...] } with predexon_id + venue_listings
• Print the raw response when exploring a path you have not used before.

Prices are probabilities 0–1. 0.62 means the market implies 62%.

Python SDK (for non-MCP use)

Inside the MCP, use blockrun_markets above. For standalone scripts:

from blockrun_llm import setup_agent_wallet   # setup_agent_solana_wallet() on Solana
client = setup_agent_wallet()

client.pm("polymarket/candlesticks/0xCONDITION_ID", interval="1h")
client.pm_query("polymarket/wallet/identities", {"addresses": ["0xabc"]})

Requires pip install blockrun-llm and a funded USDC wallet (client.get_balance()).