# Polymarket API: Search markets

> Finds Polymarket prediction markets about a topic, ranked by total trading volume, with outcome chances and market details.

Unofficial. Not affiliated with or endorsed by Polymarket.

- Page: https://fous.com/methods/polymarket.com/search-markets
- Method: `polymarket.com/search_markets`, version 1
- Website: polymarket.com
- Returns: question, event title, outcome chances, total and 24-hour volume, end date, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `topic` | string | yes | `"US election"` | Words describing the event to find, for example Fed rate cut. |
| `max_results` | integer | no | `50` | Maximum markets to return, for example 10. Default 10. |
| `include_closed` | boolean | no |  | Include closed markets too, for example false. Default false. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "topic": "US election",
  "max_results": 50
}
```

Its output:

```json
{
  "markets": [
    {
      "link": "https://polymarket.com/event/presidential-election-winner-2028/will-lebron-james-win-the-2028-us-presidential-election",
      "slug": "will-lebron-james-win-the-2028-us-presidential-election",
      "status": "open",
      "end_date": "2028-11-08",
      "outcomes": [
        {
          "name": "Yes",
          "chance_percent": 0.05
        },
        {
          "name": "No",
          "chance_percent": 99.95
        }
      ],
      "question": "Will LeBron James win the 2028 US Presidential Election?",
      "market_id": "561251",
      "event_title": "Presidential Election Winner 2028",
      "volume_24h_usd": 160,
      "total_volume_usd": 54890185.72873299
    },
    {
      "link": "https://polymarket.com/event/democratic-presidential-nominee-2028/will-oprah-winfrey-win-the-2028-democratic-presidential-nomination",
      "slug": "will-oprah-winfrey-win-the-2028-democratic-presidential-nomination",
      "status": "open",
      "end_date": "2028-11-08",
      "outcomes": [
        {
          "name": "Yes",
          "chance_percent": 0.05
        },
        {
          "name": "No",
          "chance_percent": 99.95
        }
      ],
      "question": "Will Oprah Winfrey win the 2028 Democratic presidential nomination?",
      "market_id": "559687",
      "event_title": "Democratic Presidential Nominee 2028",
      "volume_24h_usd": 1020,
      "total_volume_usd": 54443123.685758
    },
    {
      "link": "https://polymarket.com/event/democratic-presidential-nominee-2028/will-bernie-sanders-win-the-2028-democratic-presidential-nomination-879",
      "slug": "will-bernie-sanders-win-the-2028-democratic-presidential-nomination-879",
      "status": "open",
      "end_date": "2028-11-08",
      "outcomes": [
        {
          "name": "Yes",
          "chance_percent": 1.3
        },
        {
          "name": "No",
          "chance_percent": 98.7
        }
      ],
      "question": "Will Bernie Sanders win the 2028 Democratic presidential nomination?",
      "market_id": "559679",
      "event_title": "Democratic Presidential Nominee 2028",
      "volume_24h_usd": 609.122014,
      "total_volume_usd": 52919794.661988005
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"polymarket.com/search_markets","input":{"topic":"US election","max_results":50}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find the prediction markets about a Fed rate cut sorted by trading volume, showing outcome odds and end dates
- What are the biggest bitcoin price prediction markets right now with their 24-hour volume?
- Show me up to 20 markets on the next US presidential election with current chances for each candidate
- I want open and recently closed markets about AI regulation in Europe, ranked by total volume, with links
- Polymarket markets on a government shutdown this year: list the top ones with question, event title, and volume

## Input schema

```json
{
  "type": "object",
  "required": [
    "topic"
  ],
  "properties": {
    "topic": {
      "type": "string",
      "minLength": 1,
      "description": "Words describing the event to find, for example Fed rate cut."
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum markets to return, for example 10."
    },
    "include_closed": {
      "type": "boolean",
      "default": false,
      "description": "Include closed markets too, for example false."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "markets"
  ],
  "properties": {
    "markets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "question",
          "event_title",
          "outcomes",
          "total_volume_usd",
          "volume_24h_usd",
          "end_date",
          "status",
          "link",
          "market_id",
          "slug"
        ],
        "properties": {
          "link": {
            "type": "string",
            "description": "Polymarket market page."
          },
          "slug": {
            "type": "string",
            "description": "Polymarket market slug."
          },
          "status": {
            "enum": [
              "open",
              "closed"
            ],
            "type": "string",
            "description": "Market status."
          },
          "end_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Market end date."
          },
          "outcomes": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "chance_percent"
              ],
              "properties": {
                "name": {
                  "type": "string"
                },
                "chance_percent": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "additionalProperties": false
            },
            "description": "Outcome names and current chances in percent."
          },
          "question": {
            "type": "string",
            "description": "Market question."
          },
          "market_id": {
            "type": "string",
            "description": "Polymarket market ID."
          },
          "event_title": {
            "type": "string",
            "description": "Title of the enclosing event."
          },
          "volume_24h_usd": {
            "type": [
              "number",
              "null"
            ],
            "description": "24-hour trading volume in USD, if available."
          },
          "total_volume_usd": {
            "type": [
              "number",
              "null"
            ],
            "description": "Lifetime trading volume in USD."
          }
        },
        "additionalProperties": false
      },
      "description": "Matching markets, highest total trading volume first."
    }
  }
}
```

## See more

- [Polymarket API: List trending markets](https://fous.com/methods/polymarket.com/list-trending-markets.md): Lists the open Polymarket markets with the most trading in the last 24 hours. You can pick one category or list all of them; markets outside the named categories are labeled Other.
- [Polymarket API: Get odds history](https://fous.com/methods/polymarket.com/get-odds-history.md): Shows how a Polymarket outcome's chance changed over time, from a market question or a Polymarket link. For a text question it uses the highest-volume matching market.
- [Kalshi API: Search markets](https://fous.com/methods/kalshi.com/search-markets.md): Find Kalshi prediction events about a topic, ranked by total contracts traded, with Yes prices, outcome volumes and status. Settled chances show the resolved result; closed outcomes have no live buy or sell prices. Older closed markets may lack 24-hour volume; very broad searches cover up to 1,000 matches.
- [Substack API: Search newsletters](https://fous.com/methods/substack.com/search-newsletters.md): Finds public Substack newsletters matching a topic, in Substack's search order. Subscriber counts are null when Substack does not display one.
- [PolitiFact API: Search fact checks](https://fous.com/methods/politifact.com/search-fact-checks.md): Finds PolitiFact fact checks matching a claim, topic, or person, newest first. An exact person match returns that person's checked statements; otherwise fact-check text is searched. An optional Truth-O-Meter rating filters the results.
- [Meetup API: Search events](https://fous.com/methods/meetup.com/search-events.md): Finds upcoming public Meetup events by topic and city, sorted by start time. Only events that mention the topic are included; external costs and undisclosed venues may not be shown.
- [Product Hunt API: Search products](https://fous.com/methods/producthunt.com/search-products.md): Finds Product Hunt products by name or by what they do, in Product Hunt search order, with tagline, review rating, review count, followers and topics. Ratings are null for products without reviews.
- [CoinGecko API: List crypto categories](https://fous.com/methods/coingecko.com/list-crypto-categories.md): Lists CoinGecko crypto sectors by market cap with daily change, volume, leading coins and category pages, optionally filtered by name or link.
- [All Polymarket methods](https://fous.com/methods/polymarket.com.md)