---
name: "xpay-polymarket-search-markets"
description: "Search Polymarket prediction markets with filters. Find active markets, filter by tags, volume, liquidity, and more. Perfect for market discovery and analysis."
version: "1.0.0"
price: "$0.01/call"
provider: "Polymarket"
---

# Search Markets

Search Polymarket prediction markets with filters. Find active markets, filter by tags, volume, liquidity, and more. Perfect for market discovery and analysis.

**Provider:** Polymarket
**Price:** $0.01/call
**Pricing model:** Flat rate per call

## When to Use

Use this tool when you need to search polymarket prediction markets with filters. find active markets, filter by tags, volume, liquidity, and more. perfect for market discovery and analysis.. This is part of the Polymarket provider on xpay✦.

## MCP Connection

Connect to xpay✦ to access this tool (and 6+ others):

```json
{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}
```

For Claude Code:
```bash
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
```

## How to Execute

Use the xpay✦ meta-tools to run this tool:

1. **`xpay_details`** — Get full input schema: `xpay_details("polymarket/search_markets")`
2. **`xpay_run`** — Execute: `xpay_run("polymarket/search_markets", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `liquidity_min` | number | No | Minimum liquidity in USD |
| `offset` | number | No | Pagination offset |
| `query` | string | No | Search query to filter markets by question text (e.g., 'Bitcoin $100k', 'Trump wins') |
| `volume_min` | number | No | Minimum volume in USD |
| `limit` | number | No | Number of results (max 100) |
| `closed` | boolean | No | Filter by closed status (false = only active markets, true = include closed) |
| `tag_id` | number | No | Filter by tag ID (use list_tags to discover) |
| `ascending` | boolean | No | Sort direction (true = ascending, false = descending) |
| `order` | string | No | Field to order by (e.g., 'volume', 'liquidity', 'volume24hr') |

## Pricing

- **Cost:** $0.01/call
- **Balance check:** Use `xpay_balance` to check remaining credits
- Get your API key at [xpay.tools](https://xpay.tools/account/settings/api-keys/) — $5 free credits included

## Related Skills

- [Polymarket (all tools)](https://xpay.tools/skills/polymarket/SKILL.md) — 7 tools
- [Get Market](https://xpay.tools/skills/polymarket/get-market/SKILL.md) — $0.01/call
- [Search Events](https://xpay.tools/skills/polymarket/search-events/SKILL.md) — $0.01/call
- [Get Event](https://xpay.tools/skills/polymarket/get-event/SKILL.md) — $0.01/call
- [List Tags](https://xpay.tools/skills/polymarket/list-tags/SKILL.md) — $0.01/call
- [Get Trades](https://xpay.tools/skills/polymarket/get-trades/SKILL.md) — $0.01/call

## Links

- Tool page: https://xpay.tools/polymarket/search-markets/
- Provider: https://xpay.tools/polymarket/
- All tools: https://xpay.tools/explore