polymarket_event
Pack: polymarket · Endpoint: https://gateway.pipeworx.io/polymarket/mcp
Get a Polymarket event with EVERY child market at once. Events group mutually-exclusive outcomes (e.g., “2028 Democratic nominee” has one Yes/No market per candidate, each price = implied probability of that candidate). Use when you need the full slate — election candidates, championship contenders, multi-option outcomes — instead of one specific market. Returns event metadata + array of child markets with live prices, volumes, end dates.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
slug_or_id | string | yes | Event slug (e.g. “2028-presidential-election”) or numeric id |
Example call
Arguments
{
"slug_or_id": "2028-presidential-election"
}curl
curl -X POST https://gateway.pipeworx.io/polymarket/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"polymarket_event","arguments":{"slug_or_id":"2028-presidential-election"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('polymarket_event', {
"slug_or_id": "2028-presidential-election"
});More examples
{
"slug_or_id": "67890"
}Response shape
Full JSON Schema
{
"oneOf": [
{
"type": "object",
"properties": {
"error": {
"type": "string",
"enum": [
"not_found"
],
"description": "Error code"
},
"message": {
"type": "string",
"description": "Error message"
}
},
"required": [
"error",
"message"
]
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Event ID"
},
"slug": {
"type": "string",
"description": "Event slug"
},
"ticker": {
"type": [
"string",
"null"
],
"description": "Event ticker symbol"
},
"title": {
"type": "string",
"description": "Event title"
},
"description": {
"type": [
"string",
"null"
],
"description": "Event description"
},
"active": {
"type": [
"boolean",
"null"
],
"description": "Whether event is active"
},
"closed": {
"type": [
"boolean",
"null"
],
"description": "Whether event is closed"
},
"volume_total": {
"type": [
"number",
"null"
],
"description": "Total volume"
},
"volume_24hr": {
"type": [
"number",
"null"
],
"description": "24-hour volume"
},
"open_interest": {
"type": [
"number",
"null"
],
"description": "Open interest"
},
"liquidity": {
"type": [
"number",
"null"
],
"description": "Liquidity depth"
},
"competitive_score": {
"type": [
"number",
"null"
],
"description": "Competitive score"
},
"comment_count": {
"type": [
"number",
"null"
],
"description": "Number of comments"
},
"end_date": {
"type": [
"string",
"null"
],
"description": "Event end date"
},
"start_date": {
"type": [
"string",
"null"
],
"description": "Event start date"
},
"market_count": {
"type": "number",
"description": "Number of markets in event"
},
"markets": {
"type": "array",
"description": "Child markets",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Market ID"
},
"slug": {
"type": "string",
"description": "Market slug"
},
"question": {
"type": "string",
"description": "Market question"
},
"description": {
"type": [
"string",
"null"
],
"description": "Resolution criteria"
},
"outcomes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Outcome labels"
},
"yes_price": {
"type": [
"number",
"null"
],
"description": "Yes token price (probability)"
},
"no_price": {
"type": [
"number",
"null"
],
"description": "No token price (probability)"
},
"implied_probability_yes": {
"type": [
"number",
"null"
],
"description": "Implied Yes probability"
},
"volume_total": {
"type": [
"number",
"null"
],
"description": "Total volume"
},
"volume_24hr": {
"type": [
"number",
"null"
],
"description": "24-hour volume"
},
"volume_1wk": {
"type": [
"number",
"null"
],
"description": "1-week volume"
},
"volume_1mo": {
"type": [
"number",
"null"
],
"description": "1-month volume"
},
"liquidity": {
"type": [
"number",
"null"
],
"description": "Liquidity depth"
},
"active": {
"type": [
"boolean",
"null"
],
"description": "Whether market is active"
},
"closed": {
"type": [
"boolean",
"null"
],
"description": "Whether market is closed"
},
"accepting_orders": {
"type": [
"boolean",
"null"
],
"description": "Whether market accepts orders"
},
"end_date": {
"type": [
"string",
"null"
],
"description": "Market end date"
},
"start_date": {
"type": [
"string",
"null"
],
"description": "Market start date"
},
"image": {
"type": [
"string",
"null"
],
"description": "Image URL"
},
"url": {
"type": "string",
"description": "Polymarket URL"
}
}
}
},
"url": {
"type": "string",
"description": "Polymarket event URL"
}
},
"required": [
"id",
"slug",
"title",
"url"
]
}
]
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"polymarket": {
"url": "https://gateway.pipeworx.io/polymarket/mcp"
}
}
}See Getting Started for client-specific install steps.