Polymarket Sync Events

Polymarket - Sync Events

Syncs active sports events from Polymarket Gamma API into polymarket-events documents with vector embeddings.

Workflow

Name: polymarket-sync-events

Usage

# Sync all sports events
mcp__docker-localhost__execute_workflow(
    name="polymarket-sync-events",
    input_data={"tag_id": 1, "limit": 100}
)

# Sync events from a specific series/league
mcp__docker-localhost__execute_workflow(
    name="polymarket-sync-events",
    input_data={"series_id": "<series_id>", "limit": 50}
)

Pipeline

get_sports_events → polymarket-event-mapping → bulk-save (polymarket-events)

Dependencies

• polymarket connector (no auth required)
• machina-ai connector (for embeddings) — requires $TEMP_CONTEXT_VARIABLE_SDK_OPENAI_API_KEY

Polymarket Events API

Reference for browsing and syncing sports events from Polymarket.

What is an Event?

An event groups related markets for a single game or match. For example, "Lakers vs Celtics" is an event that contains markets like moneyline, spread, total, and player props.

Fetching Events

# All active sports events
mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_sports_events",
    payload={"tag_id": 1, "limit": 50}
)

# Events from a specific series/league
mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_sports_events",
    payload={"series_id": "<series_id>", "limit": 50}
)

# Single event by ID
mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_event_details",
    payload={"event_id": "<event_id>"}
)

# Single event by slug
mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_event_details",
    payload={"slug": "lakers-vs-celtics"}
)

Event Data Structure

Each synced event document contains:

{
  "title": "Lakers vs Celtics",
  "description": "NBA regular season game",
  "slug": "lakers-vs-celtics-feb-20",
  "status": "active",
  "startDate": "2026-02-20T00:00:00Z",
  "endDate": "2026-02-21T00:00:00Z",
  "volume": 500000.0,
  "liquidity": 200000.0,
  "marketCount": 12,
  "seriesId": "nba-2025-26",
  "tags": ["NBA", "Basketball"]
}

Query Parameters

Event → Markets Relationship

Events contain embedded markets. When fetching event details, all associated markets are returned with current prices. Use event_id in market data to cross-reference.

Polymarket Search

Reference for searching markets and events across Polymarket.

Search Markets

Full-text search across event titles, descriptions, and slugs:

mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="search_markets",
    payload={
        "query": "nba",
        "limit": 20
    }
)

# Search with market type filter
mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="search_markets",
    payload={
        "query": "chiefs",
        "sports_market_types": "moneyline",
        "limit": 10
    }
)

Search Behavior

• Searches across event title, description, and slug fields
• Case-insensitive matching
• Returns markets from matching events (not events themselves)
• Results ordered by volume (highest first)
• Max 50 results per query

Search Examples

Tips

• Use specific team/player names for best results
• Combine with sports_market_types to narrow down (e.g., only moneyline)
• For browsing by league, use get_sports_events with series_id instead
• For browsing all market types, use get_sports_market_types first