Polymarket Sync Markets

Polymarket - Sync Markets

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

Workflow

Name: polymarket-sync-markets

Usage

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

# Sync only moneyline markets
mcp__docker-localhost__execute_workflow(
    name="polymarket-sync-markets",
    input_data={"sports_market_types": "moneyline", "limit": 50}
)

Pipeline

get_sports_markets → polymarket-market-mapping → bulk-save (polymarket-markets)

Dependencies

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

Polymarket Sports Market Types

Reference for the 58+ market types available on Polymarket sports.

Common Market Types

Filtering by Market Type

# Sync only moneyline markets
mcp__docker-localhost__execute_workflow(
    name="polymarket-sync-markets",
    input_data={"sports_market_types": "moneyline", "limit": 100}
)

# Get all available market types
mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_sports_market_types",
    payload={}
)

Market Data Structure

Each synced market document contains:

{
  "title": "Will the Lakers win vs Celtics?",
  "sportsMarketType": "moneyline",
  "gameId": "game_abc123",
  "outcomes": [
    {"name": "Yes", "price": 0.55, "clob_token_id": "tok_yes"},
    {"name": "No", "price": 0.45, "clob_token_id": "tok_no"}
  ],
  "volume": 150000.0,
  "volume24h": 25000.0,
  "liquidity": 80000.0,
  "spread": 0.02,
  "startDate": "2026-02-20T00:00:00Z",
  "endDate": "2026-02-21T00:00:00Z",
  "eventId": "evt_123",
  "tags": ["NBA", "Basketball"]
}

Price Interpretation

• Prices are probabilities from 0.0 to 1.0
• Price 0.65 = 65% implied probability
• American odds conversion: price > 0.5 → -(price/(1-price)*100) else +((1-price)/price*100)
• Example: 0.65 → -186, 0.35 → +186

Polymarket Pricing API (CLOB)

Reference for real-time pricing, order books, and trade history via the CLOB API.

Getting Real-Time Prices

Use clob_token_id from market outcomes to fetch live prices.

# Get midpoint + buy/sell prices for a token
mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_market_prices",
    payload={"token_id": "<clob_token_id>"}
)
# Returns: {midpoint: 0.65, buy_price: 0.64, sell_price: 0.66}

# Batch prices for multiple tokens (max 20)
mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_market_prices",
    payload={"token_ids": ["tok_1", "tok_2", "tok_3"]}
)

Order Book

mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_order_book",
    payload={"token_id": "<clob_token_id>"}
)
# Returns: {bids: [...], asks: [...], best_bid, best_ask, spread, bid_depth, ask_depth}

Price History

mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_price_history",
    payload={
        "token_id": "<clob_token_id>",
        "interval": "max",   # or "1d", "1w", "1m"
        "fidelity": 120      # data points
    }
)

Last Trade Price

mcp__docker-localhost__connector_executor(
    name="polymarket",
    command="get_last_trade_price",
    payload={"token_id": "<clob_token_id>"}
)
# Returns: {price: 0.65, side: "BUY"}

API Endpoints

All CLOB endpoints are public and require no authentication.