Prediction Markets (Predexon)

55 endpoints across Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, 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: "1440" } })

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.

Paid calls can run in parallel on Base: each EIP-3009 authorization carries its own random nonce, so concurrent calls from one wallet cannot collide. The Solana payload has no nonce field — distinctness comes from the SDK (@blockrun/llm >= 3.8.4), so keep that floor if you fan out on Solana.

Current parameter contracts that prevent paid 4xx responses:

• Discover with markets/search (its search term is q), then resolve the selected market with polymarket/markets/keyset + condition_id.
• On polymarket/markets{,/keyset} the free-text filter is search, not q. Use status:"open" rather than Gamma's active/closed, and sort rather than order/ascending. end_after/end_before are supported (Unix seconds).
• Candlestick interval is integer minutes (1440, not 1h) and is optional — the server has a default. Which intervals a market can serve varies: 1440 may work where 60 returns a paid 400. Optional start_time/end_time are Unix seconds.
• polymarket/orderbooks requires token_id, start_time, and end_time; the times are Unix milliseconds.
• Smart-money needs a smart-wallet criterion: min_trades, min_volume, min_roi, min_realized_pnl, min_total_pnl, min_win_rate, or min_profit_factor. window only scopes the time range and is not sufficient alone (verified: window-only returns a paid 400). Use { window: "30d", min_trades: "100" }; narrower cohorts are fine.
• markets/listings is retired upstream (410 Gone) — the MCP blocks it before payment.

Two Pricing Tiers

Tier	Price	What
All endpoints	$0.0085	Market data, events, history, candles, orderbooks, trades, leaderboard, sports, UMA, wallet analytics, smart money, identity + clustering, cross-venue matching, Binance

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

Quick Decision Table — "User asks about X"

User wants…	path	Tier
Same question across venues	markets	1
Search every venue at once	markets/search	2
Resolve a canonical outcome ID	outcomes/{predexon_id}	1
Equivalent markets (arbitrage)	matching-markets	2
Active matched pairs	matching-markets/pairs	2
Active Polymarket events	polymarket/events	1
Polymarket markets	polymarket/markets	1
Large result sets (stable paging)	polymarket/markets/keyset	1
Crypto up/down markets	polymarket/crypto-updown	1
Current/historical price of a token	polymarket/market-price/{token_id}	1
Price history (OHLCV)	polymarket/candlesticks/{condition_id}	1
OHLCV for one outcome	polymarket/candlesticks/token/{token_id}	1
Volume over time (YES/NO split)	polymarket/volume-chart/{condition_id}	1
Historical orderbook snapshots	polymarket/orderbooks	1
Historical trades	polymarket/trades	1
Merges / splits / redeems for a user	polymarket/activity	1
Cumulative volume for a market	polymarket/markets/{token_id}/volume	1
Open interest history	polymarket/markets/{condition_id}/open_interest	1
Positions (filterable)	polymarket/positions	1
Global smart-wallet leaderboard	polymarket/leaderboard	1
Leaderboard for one market	polymarket/leaderboard/market/{condition_id}	1
Cohort performance by trading style	polymarket/cohorts/stats	1
Top holders of a market	polymarket/market/{condition_id}/top-holders	1
Smart money on a market	polymarket/market/{condition_id}/smart-money	2
Markets smart wallets just entered	polymarket/markets/smart-activity	2
Full smart-wallet profile	polymarket/wallet/{wallet}	2
Per-market breakdown for a wallet	polymarket/wallet/{wallet}/markets	2
Wallets with similar portfolios	polymarket/wallet/{wallet}/similar	2
Wallet P&L + realized series	polymarket/wallet/pnl/{wallet}	2
Wallet open/historical positions	polymarket/wallet/positions/{wallet}	2
Wallet volume by BUY/SELL side	polymarket/wallet/volume-chart/{wallet}	2
Batch wallet profiles	polymarket/wallets/profiles	2
Filter wallets by markets traded	polymarket/wallets/filter	2
Wallet identity (ENS/Twitter/etc)	polymarket/wallet/identity/{wallet}	2
Bulk identity (≤200, POST)	polymarket/wallet/identities	2
On-chain cluster for a wallet	polymarket/wallet/{address}/cluster	2
UMA oracle questions by state	polymarket/uma/markets	1
UMA status + timeline for a market	polymarket/uma/market/{condition_id}	1
Kalshi markets	kalshi/markets	1
Kalshi trades / orderbooks	kalshi/trades, kalshi/orderbooks	1
Sports categories	sports/categories	1
Sports markets by league	sports/markets	1
One game, all venue outcomes	sports/markets/{game_id}	1
Equivalent sports outcomes	sports/outcomes/{predexon_id}	1
Limitless / Opinion / Predict.Fun markets	limitless/markets, opinion/markets, predictfun/markets	1
Their historical orderbook snapshots	limitless/orderbooks, opinion/orderbooks, predictfun/orderbooks	1
Binance candles / ticks	binance/candles/{symbol}, binance/ticks/{symbol}	2

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: "1440", start_time: "<UNIX_SECONDS>", end_time: "<UNIX_SECONDS>"
} })
blockrun_markets({ path: "polymarket/volume-chart/0xCONDITION_ID" })
blockrun_markets({ path: "polymarket/markets/0xCONDITION_ID/open_interest" })
blockrun_markets({ path: "polymarket/orderbooks", params: {
  token_id: "<TOKEN_ID>", start_time: "<UNIX_MILLISECONDS>", end_time: "<UNIX_MILLISECONDS>"
} })

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", params: {
  window: "30d", min_trades: "100"
} })

// 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="1440")
client.pm_query("polymarket/wallet/identities", {"addresses": ["0xabc"]})

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