Polymarket

Polymarket on xpay — Real-time prediction market data without the signup friction

Polymarket is a leading decentralized prediction market platform where users trade on the outcomes of real-world events. Developers integrate Polymarket to surface market probabilities, discover trending events, analyze trading activity, and build prediction-driven applications—from financial dashboards to event-tracking bots to AI agents that reason about future outcomes.

xpay wraps Polymarket's API as MCP-callable tools with transparent per-call pricing. You authenticate once with your xpay key; xpay handles the upstream Polymarket credentials. No separate Polymarket account, no subscription, no rate-limit surprises—just call what you need and pay $0.01 per call.

What's available

• search_markets — Find prediction markets by keyword, tag, volume, liquidity, and other filters. Discover active markets and filter results for market research or discovery workflows.
• get_market — Retrieve full details for a specific market: probabilities, trading volume, liquidity, outcomes, and metadata. The foundation for market analysis and monitoring.
• search_events — Search Polymarket events (thematic groupings of related markets, e.g., "2024 Presidential Election"). Ideal for discovering market clusters around major topics.
• get_event — Get comprehensive event data including all related markets, probabilities, and trading activity.
• list_tags — Enumerate all available tags and categories. Use tag IDs to filter search_markets and search_events for targeted queries.
• get_trades — Fetch recent trade activity and order flow. Analyze sentiment, volume spikes, and trader behavior in real time.
• analyze_market — One-call market intelligence combining probabilities, recent trades, and AI-friendly insights. Perfect for agents that need to reason about market state.

When Polymarket is the right tool

• You're building a prediction-driven dashboard or alert system that monitors market probabilities and trading activity.
• You need real-time event discovery and want to surface trending markets or specific event clusters to users.
• You're developing an AI agent that reasons about future outcomes, geopolitical events, or financial markets and needs live probability data.
• You're running quantitative analysis on trading patterns, order flow, or market microstructure.
• You want to embed market data into a bot, workflow, or application without managing your own Polymarket infrastructure or API keys.

When to choose something else

• You need historical market data spanning months or years; Polymarket's API is optimized for current and recent data.
• You're building a high-frequency trading system that requires sub-millisecond latency; MCP is a request-response protocol and may introduce latency.
• You need on-chain transaction details beyond market probabilities; consider querying the blockchain directly or using a dedicated on-chain indexer.
• Your use case is internal only and you already have a Polymarket API key; direct API calls may be simpler than routing through xpay.

Pricing snapshot

All Polymarket tools on xpay cost $0.01 per call. No subscription, no monthly minimums. You receive $5 free credit on signup to explore.

Quickstart

Install the per-provider endpoint (recommended for Polymarket alone):

claude mcp add --transport http polymarket "https://polymarket.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"

Replace YOUR_XPAY_KEY with your xpay API key (get it free at https://xpay.tools after email or Google signup).

Once connected, Claude Code will recognize Polymarket tools by their native names. Ask Claude to "search for markets about the 2024 election" and it will invoke search_markets with the appropriate filters.

Alternatively, connect all xpay providers in one endpoint:

claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"

With the unified endpoint, use xpay_discover("polymarket") to find tools, then call them via xpay_run("polymarket/search_markets", {...}). This approach is useful if you're also using other xpay providers (e.g., Tavily, Apollo, NewsAPI).

For Cursor, Windsurf, Cline, or VS Code (Copilot): Add a server entry to your mcp.json file:

{
  "mcpServers": {
    "polymarket": {
      "url": "https://polymarket.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"
    }
  }
}

Why route Polymarket through xpay?

• No Polymarket signup. xpay holds the upstream credentials; you authenticate once with your xpay key and immediately access Polymarket's full API.
• Transparent per-call pricing. Every call costs $0.01. No hidden fees, no subscription lock-in, no rate-limit overages. You see exactly what you spend.
• MCP-native integration. Call Polymarket tools directly from Claude Code, Cursor, Cline, and other MCP-compatible agents. No custom HTTP client or SDK needed.
• Unified billing across providers. If you also use Tavily, Apollo, NewsAPI, or other xpay providers, one invoice covers everything.
• Instant access. Start querying markets in seconds. No API key management, no waiting for Polymarket approval.