Prediction markets, Polymarket events

$0.01 per call · failed calls are never charged · no account or subscription: pay per call with a card key or USDC

Polymarket events (one question with one or several markets, such as an election with many candidates): the busiest open events by 24-hour volume or those matching a search, with volume, liquidity, end date, tags, the number of open markets and the five leading outcomes by price. Use to see who leads a multi-candidate market or to browse what is being traded now.

Guide: Polymarket API, prediction market odds

Run it free (25 free calls) Buy credits by card (from $1) Example result (JSON)

Try it with your own inputs

Optional search, e.g. president 2028; without it the busiest events by 24h volume

Uses one of your 25 free calls. Nothing is charged, and a call that fails is not counted.

Inputs

NameTypeDescription
qstringOptional search, e.g. president 2028; without it the busiest events by 24h volume
limitintegerEvents to return, 1-10 (default 5)

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/polymarket/events?q=president"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/polymarket/events?q=president&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

Example result

{
  "query": "president",
  "count": 1,
  "events": [
    {
      "title": "Republican Presidential Nominee 2028",
      "slug": "republican-presidential-nominee-2028",
      "url": "https://polymarket.com/event/republican-presidential-nominee-2028",
      "endDate": "2028-11-08T04:59:00Z",
      "volume24h": 2470204.52,
      "volume": 727850358.28,
      "liquidity": 32474302.97,
      "tags": [
        "Politics"
      ],
      "openMarkets": 128,
      "leading": [
        {
          "title": "J.D. Vance",
          "slug": "will-jd-vance-win-the-2028-republican-presidential-nomination",
          "yesPrice": 0.52,
          "volume24h": 300000
        }
      ]
    }
  ],
  "note": "Polymarket public data at call time; prices are the market's implied probability (0-1). Not financial advice.",
  "checkedAt": "2026-11-05T16:40:00.000Z"
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is polymarket_events, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools