Prediction Markets API

Real-time prediction market odds and probabilities from Polymarket. Browse active markets, get detailed odds on specific events, and discover trending bets -- all via x402 micropayments.

What It Does / Endpoints

Example Request / Response

List Markets

curl -X POST https://prediction-markets-production.up.railway.app/api/markets \
  -H "Content-Type: application/json" \
  -d '{"category": "politics", "limit": 5, "sort": "volume"}'

{
  "markets": [
    {
      "id": "0x1234...",
      "question": "Will Trump win the 2028 presidential election?",
      "outcomes": ["Yes", "No"],
      "outcomePrices": { "Yes": 0.42, "No": 0.58 },
      "volume": 15420000,
      "volume24h": 234000,
      "liquidity": 890000,
      "endDate": "2028-11-06T00:00:00Z",
      "category": "politics",
      "active": true
    }
  ],
  "count": 5,
  "sort": "volume",
  "category": "politics",
  "source": "polymarket"
}

Get Odds (Search by Query)

curl -X POST https://prediction-markets-production.up.railway.app/api/odds \
  -H "Content-Type: application/json" \
  -d '{"query": "bitcoin 100k"}'

{
  "id": "0xabcd...",
  "question": "Will Bitcoin reach $100k by December 2026?",
  "outcomes": ["Yes", "No"],
  "outcomePrices": { "Yes": 0.65, "No": 0.35 },
  "volume": 8900000,
  "volume24h": 120000,
  "liquidity": 450000,
  "endDate": "2026-12-31T00:00:00Z",
  "category": "crypto",
  "active": true,
  "source": "polymarket"
}

Trending Markets

curl -X POST https://prediction-markets-production.up.railway.app/api/trending \
  -H "Content-Type: application/json" \
  -d '{"limit": 5}'

{
  "trending": [
    {
      "id": "0x5678...",
      "question": "Will the Fed cut rates in July 2026?",
      "probability": 0.73,
      "outcomePrices": { "Yes": 0.73, "No": 0.27 },
      "volume24h": 890000,
      "totalVolume": 12500000,
      "category": "politics",
      "endDate": "2026-07-31T00:00:00Z",
      "active": true
    }
  ],
  "count": 5,
  "source": "polymarket"
}

Use Cases

• Election odds: Get real-time probabilities on political outcomes backed by real money
• Crypto predictions: Check market consensus on price targets, ETF approvals, protocol upgrades
• Event forecasting: Find the crowd-sourced probability of any major world event
• Research & analysis: Use prediction market data as a signal for decision-making
• News impact: See how breaking events shift market probabilities in real time

MCP Integration

Add to your Claude Desktop or Cursor MCP config:

{
  "mcpServers": {
    "prediction-markets": {
      "url": "https://prediction-markets-production.up.railway.app/sse"
    }
  }
}

Tools available via MCP:

• prediction_list_markets -- Browse active markets by category and sort
• prediction_get_market_odds -- Get detailed odds by market ID or search query
• prediction_trending_markets -- Discover trending markets by volume

Payment

All endpoints are gated by x402 micropayments (USDC on Base L2). Agents pay automatically per call -- no API keys, no subscriptions.

Related APIs

• Trust Score API -- Verify domain/wallet trust before interacting
• Token Price API -- Real-time crypto token prices
• Crypto News API -- Latest crypto news and sentiment
• DeFi Yields API -- Best DeFi yield opportunities
• [Hyperliquid API](https://github.com/Br0ski777/hyperliquid-x40

... View full README on GitHub