Skip to content
Eden Engine

Polymarket Event Odds & Markets (by Event Slug)

omnial/prediction-market-polymarket-events

Given a Polymarket event slug, returns that event's nested Yes/No markets: each market's question, status, resolution description, Yes/No outcome ids and labels, trading volume over several windows, and (once decided) the winning side. An unmatched slug returns an empty result rather than an error.

activeper callv2

Price

Up to $0.0328 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

Polymarket

Data from Polymarket.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/prediction-market-polymarket-events" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/prediction-market-polymarket-events" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/prediction-market-polymarket-events", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/prediction-market-polymarket-events", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0328
Updated
Oct 27, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "event_slug"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page. Example: 20. Defaults to 20."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Pagination offset. Example: 0. Defaults to 0."
    },
    "event_slug": {
      "type": "string",
      "minLength": 1,
      "description": "Polymarket event slug (identifies a multi-outcome question with several nested markets). Known World Cup match sibling slugs are expanded to the canonical match group. Discover slugs via /v1/search/prediction-market?platform=polymarket&q={keyword}. For a single Yes/No market, use /polymarket/markets with market_slug instead — this endpoint only accepts event_slug, not market_slug. Example: what-price-will-bitcoin-hit-before-2027."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "e.g. 'open'."
          },
          "markets": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "title": {
                  "type": "string"
                },
                "side_a": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "The outcome's on-chain token id, not a phone number."
                    },
                    "label": {
                      "type": "string"
                    }
                  },
                  "description": "The market's first outcome (typically 'Yes').",
                  "additionalProperties": false
                },
                "side_b": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "The outcome's on-chain token id, not a phone number."
                    },
                    "label": {
                      "type": "string"
                    }
                  },
                  "description": "The market's second outcome (typically 'No').",
                  "additionalProperties": false
                },
                "status": {
                  "type": "string",
                  "description": "e.g. 'open', 'closed'."
                },
                "category": {
                  "type": "string"
                },
                "end_time": {
                  "type": "number",
                  "description": "Unix seconds."
                },
                "close_time": {
                  "type": "number",
                  "description": "Unix seconds; 0 when the market has not closed yet."
                },
                "event_slug": {
                  "type": "string"
                },
                "start_time": {
                  "type": "number",
                  "description": "Unix seconds."
                },
                "description": {
                  "type": "string",
                  "description": "The resolution criteria in prose -- what makes this market resolve Yes vs No."
                },
                "market_slug": {
                  "type": "string",
                  "description": "The market's own slug, distinct from the parent event_slug."
                },
                "subcategory": {
                  "type": "string"
                },
                "condition_id": {
                  "type": "string",
                  "description": "The on-chain condition id identifying this market's resolution contract."
                },
                "volume_total": {
                  "type": "number",
                  "description": "Total traded volume in USD."
                },
                "winning_side": {
                  "type": "string",
                  "description": "Only present once a market has resolved -- absent (not null) on every still-open market; do not assume this key exists."
                },
                "volume_1_week": {
                  "type": "number",
                  "description": "Traded volume in USD, trailing 1 week."
                },
                "volume_1_year": {
                  "type": "number",
                  "description": "Traded volume in USD, trailing 1 year."
                },
                "completed_time": {
                  "type": "number",
                  "description": "Unix seconds; 0 when the market has not resolved yet."
                },
                "volume_1_month": {
                  "type": "number",
                  "description": "Traded volume in USD, trailing 1 month."
                },
                "game_start_time": {
                  "type": "number",
                  "description": "0 on every non-sports market observed; likely populated for sports events."
                }
              },
              "additionalProperties": false
            },
            "description": "The event's nested Yes/No markets."
          },
          "category": {
            "type": "string"
          },
          "end_time": {
            "type": "number",
            "description": "Unix seconds."
          },
          "event_slug": {
            "type": "string"
          },
          "start_time": {
            "type": "number",
            "description": "Unix seconds."
          },
          "description": {
            "type": "string"
          },
          "subcategory": {
            "type": "string"
          },
          "market_count": {
            "type": "number"
          },
          "volume_total": {
            "type": "number",
            "description": "Total traded volume across the event's markets, in USD."
          }
        },
        "additionalProperties": false
      },
      "description": "Empty when the slug matches no event -- not an error case, the call still completes normally."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number"
        },
        "total": {
          "type": "number"
        },
        "cached": {
          "type": "boolean"
        },
        "offset": {
          "type": "number"
        }
      },
      "additionalProperties": false
    }
  },
  "description": "The event list for the requested slug.",
  "additionalProperties": false
}