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://tools.funwords.eu/polymarket/events?q=president"

Or one of your 25 free calls, no key:

curl "https://tools.funwords.eu/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.

Live result

The real answer to the request above, read 2026-11-10 14:43 UTC and refreshed every 15 minutes.

{
  "query": "president",
  "count": 5,
  "events": [
    {
      "title": "Presidential Election Winner 2028",
      "slug": "presidential-election-winner-2028",
      "url": "https://polymarket.com/event/presidential-election-winner-2028",
      "endDate": "2028-11-08T04:59:00Z",
      "volume24h": 1122785.42,
      "volume": 737943375.22,
      "liquidity": 54143981.97,
      "tags": [
        "President",
        "United States",
        "US Election",
        "Elections",
        "Politics",
        "World Elections"
      ],
      "openMarkets": 128,
      "leading": [
        {
          "title": "JD Vance",
          "slug": "will-jd-vance-win-the-2028-us-presidential-election",
          "yesPrice": 0.1735,
          "volume24h": 4916
        },
        {
          "title": "Jon Ossoff",
          "slug": "will-jon-ossoff-win-the-2028-us-presidential-election",
          "yesPrice": 0.1735,
          "volume24h": 71415.99
        },
        {
          "title": "Alexandria Ocasio-Cortez",
          "slug": "will-alexandria-ocasio-cortez-win-the-2028-us-presidential-election",
          "yesPrice": 0.1115,
          "volume24h": 7504.07
        },
        {
          "title": "Marco Rubio",
          "slug": "will-marco-rubio-win-the-2028-us-presidential-election",
          "yesPrice": 0.0925,
          "volume24h": 6531.82
        },
        {
          "title": "Gavin Newsom",
          "slug": "will-gavin-newsom-win-the-2028-us-presidential-election",
          "yesPrice": 0.0815,
          "volume24h": 20929.94
        }
      ]
    },
    {
      "title": "Who will announce Presidential run before 2028?",
      "slug": "who-will-announce-presidential-run-before-2028-20260803142755224",
      "url": "https://polymarket.com/event/who-will-announce-presidential-run-before-2028-20260803142755224",
      "endDate": "2028-01-01T04:59:00Z",
      "volume24h": 9138.83,
      "volume": 241079.81,
      "liquidity": 458299.62,
      "tags": [
        "Politics",
        "Elections",
        "President",
        "Celebrities",
        "2028 Election"
      ],
      "openMarkets": 72,
      "leading": [
        {
          "title": "Pete Buttigieg",
          "slug": "will-pete-buttigieg-announce-a-presidential-run-before-2028-20260803143241607",
          "yesPrice": 0.9875,
          "volume24h": 6.72
        },
        {
          "title": "Andy Beshear",
          "slug": "will-andy-beshear-announce-a-presidential-run-before-2028-20260803143241613",
          "yesPrice": 0.9125,
          "volume24h": 23.74
        },
        {
          "title": "Ron DeSantis",
          "slug": "will-ron-desantis-announce-a-presidential-run-before-2028-20260803143241650",
          "yesPrice": 0.91,
          "volume24h": 339.11
        },
        {
          "title": "Josh Shapiro",
          "slug": "will-josh-shapiro-announce-a-presidential-run-before-2028-20260803143241608",
          "yesPrice": 0.85,
          "volume24h": 142.72
        },
        {
          "title": "Ted Cruz",
          "slug": "will-ted-cruz-announce-a-presidential-run-before-2028-20260803143241659",
          "yesPrice": 0.845,
          "volume24h": 108.54
        }
      ]
    },
    {
      "title": "Who will announce Presidential run before 2027?",
      "slug": "who-will-announce-presidential-run-before-2027",
      "url": "https://polymarket.com/event/who-will-announce-presidential-run-before-2027",
      "endDate": "2027-01-01T04:59:00Z",
      "volume24h": 5863.7,
      "volume": 1410624.61,
      "liquidity": 1025961.74,
      "tags": [
        "Politics",
        "Celebrities",
        "Elections",
        "President",
        "2028 Election"
      ],
      "openMarkets": 72,
      "leading": [
        {
          "title": "Rahm Emanuel",
          "slug": "will-rahm-emanuel-announce-a-presidential-run-before-2027",
          "yesPrice": 0.2685,
          "volume24h": 336.66
        },
        {
          "title": "Tulsi Gabbard",
          "slug"
…

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://tools.funwords.eu/mcp

Related tools