prediction-markets

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.