---
name: "xpay-polymarket-search-events"
description: "Search Polymarket events. Events group related markets together (e.g., 'Presidential Election 2024' contains multiple markets). Great for discovering market clusters."
version: "1.0.0"
price: "$0.01/call"
provider: "Polymarket"
---

# Search Events

Search Polymarket events. Events group related markets together (e.g., 'Presidential Election 2024' contains multiple markets). Great for discovering market clusters.

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

## When to Use

Use this tool when you need to search polymarket events. events group related markets together (e.g., 'presidential election 2024' contains multiple markets). great for discovering market clusters.. 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_events")`
2. **`xpay_run`** — Execute: `xpay_run("polymarket/search_events", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `featured` | boolean | No | Show only featured events |
| `offset` | number | No | Pagination offset |
| `limit` | number | No | Number of results (max 100) |
| `closed` | boolean | No | Filter by closed status |
| `tag_id` | number | No | Filter by tag ID |
| `ascending` | boolean | No | Sort direction |
| `order` | string | No | Field to order by |

## 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
- [Search Markets](https://xpay.tools/skills/polymarket/search-markets/SKILL.md) — $0.01/call
- [Get Market](https://xpay.tools/skills/polymarket/get-market/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-events/
- Provider: https://xpay.tools/polymarket/
- All tools: https://xpay.tools/explore