Polymarket Sync Series

Name: Polymarket Sync Series
Author: machina-sports

machina-sports/polymarket-template

2 installs
Updated February 16, 2026
machina-sports/polymarket-template

Syncs series (leagues/competitions) from the Polymarket Gamma API into documents with vector embeddings.

About

Fetches Polymarket series data, maps it to polymarket-series documents, and stores it with embeddings, supporting limit and offset pagination. A developer uses it to import prediction-market leagues and competitions.

Fetches leagues/competitions with limit and offset paging
Pipeline: get_series, mapping, bulk-save with embeddings

Polymarket Sync Series by the numbers

2 all-time installs (skills.sh)
Ranked #870 of 1,106 Finance & Trading skills by installs in the Skillselion catalog
Data as of Aug 2, 2026 (Skillselion catalog sync)

npx skills add https://github.com/machina-sports/polymarket-template --skill polymarket-sync-series

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/machina-sports/polymarket-template/polymarket-sync-series.svg)](https://skillselion.com/skills/machina-sports/polymarket-template/polymarket-sync-series)

Installs	2
Last updated	February 16, 2026
Repository	machina-sports/polymarket-template ↗

What it does

Syncs series (leagues/competitions) from the Polymarket Gamma API into documents with vector embeddings.

Files

SKILL.mdMarkdownGitHub ↗

Polymarket - Sync Series

Syncs series (leagues/competitions) from Polymarket Gamma API into polymarket-series documents with vector embeddings.

Workflow

Name: polymarket-sync-series

Input	Default	Description
`limit`	`200`	Max series to fetch
`offset`	`0`	Pagination offset

Usage

# Sync all series
mcp__docker-localhost__execute_workflow(name="polymarket-sync-series")

# Sync with pagination
mcp__docker-localhost__execute_workflow(
    name="polymarket-sync-series",
    input_data={"limit": 200, "offset": 0}
)

Pipeline

get_series → polymarket-series-mapping → bulk-save (polymarket-series)

Dependencies

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

Polymarket Series API

Reference for browsing series (leagues/competitions) on Polymarket.

What is a Series?

A series represents a league or competition that groups related events. For example, "NBA 2025-26" is a series containing all NBA game events for that season.

Fetching Series

# All series
mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_series",
    payload={"limit": 200}
)

Series Data Structure

Each synced series document contains:

{
  "title": "NBA 2025-26",
  "slug": "nba-2025-26",
  "description": "NBA 2025-26 Regular Season",
  "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nba.png",
  "createdAt": "2025-10-01T00:00:00Z",
  "updatedAt": "2026-02-15T00:00:00Z"
}

Using Series to Filter Events

Get the series ID from synced documents, then use it to filter events:

# 1. Find the NBA series
# Search polymarket-series documents for "NBA"

# 2. Use series_id to get NBA events only
mcp__docker-localhost__execute_workflow(
    name="polymarket-sync-events",
    input_data={"series_id": "<nba_series_id>", "limit": 100}
)

Query Parameters

Parameter	Type	Default	Description
`limit`	int	`100`	Max results (max 200)
`offset`	int	`0`	Pagination offset

Common Series

Sports series on Polymarket typically follow the pattern {sport} {season}:

NBA 2025-26
NFL 2025-26
MLB 2026
Premier League 2025-26
Champions League 2025-26
UFC / MMA
Tennis Grand Slams

Polymarket Sports Coverage

Reference for sports and competitions available on Polymarket.

Supported Sports

Sport	Coverage	Market Types
NFL	Full season, playoffs, Super Bowl	Moneyline, spread, total, player props
NBA	Full season, playoffs, Finals	Moneyline, spread, total, player props
MLB	Full season, playoffs, World Series	Moneyline, spread, total, player props
Soccer	Premier League, Champions League, MLS	Moneyline, total, props
Tennis	Grand Slams, ATP/WTA	Match winner
MMA/UFC	Main events	Fight winner
Cricket	Major tournaments	Match winner
Esports	Major tournaments	Match winner

Tag System

Polymarket uses tags to categorize content:

Tag ID	Category
`1`	Sports (default)

All sports connector commands default to tag_id=1.

Market Volume

Markets are sorted by volume (total trading volume in USD). High-volume markets have:

Better liquidity
Tighter spreads
More reliable pricing
More frequent price updates

Seasonal Patterns

NFL: September → February (highest volume during playoffs)
NBA: October → June
MLB: March → October
Soccer: Year-round (multiple leagues)
UFC/MMA: Year-round (event-based)

skill:
  name: "polymarket-sync-series"
  title: "Polymarket - Sync Series"
  description: "Sync series (leagues/competitions) from Polymarket to Machina documents."
  version: "1.0.0"
  category:
    - "data-acquisition"
    - "prediction-markets"
  status: "available"
  domain: "https://github.com/machina-sports/polymarket-template"

  references:

    - name: "skill-reference"
      title: "Series API"
      filename: "references/series-api.md"
      filetype: "markdown"
      metadata:
        category: "reference"
        skill: "polymarket-sync-series"
        reference_id: "series-api"

    - name: "skill-reference"
      title: "Sports Coverage"
      filename: "references/sports-coverage.md"
      filetype: "markdown"
      metadata:
        category: "reference"
        skill: "polymarket-sync-series"
        reference_id: "sports-coverage"

  workflows:

    - name: "polymarket-sync-series"
      description: "sync-series-leagues"
      inputs:
        limit: "$.get('limit', 200)"
        offset: "$.get('offset', 0)"
      outputs:
        workflow-status: "$.get('workflow-status', 'skipped')"