Build an OpenClaw World Cup 2026 Odds Skill — Aggregate Tournament Betting Lines

mkdir -p ~/.openclaw/skills/world-cup-2026-odds

---
name: world-cup-2026-odds
description: "Aggregate FIFA World Cup 2026 odds across sportsbooks and prediction markets. Track outright winner futures, group stage odds, and match lines. Compare Polymarket prices vs traditional book futures. Use when asked about World Cup odds, World Cup winner, or 2026 tournament betting."
metadata:
  openclaw:
    emoji: "🏆"
    requires:
      bins: ["curl", "jq"]
    credentials:
      - id: "odds-api-key"
        name: "The Odds API Key"
        description: "Free API key from https://the-odds-api.com/"
        env: "ODDS_API_KEY"
---

# World Cup 2026 Odds Tracker

Aggregate FIFA World Cup 2026 betting odds from sportsbooks and prediction markets into one unified view.

# When to Use

Use this skill when the user asks about:
- World Cup 2026 odds, futures, or predictions
- Who will win the World Cup
- World Cup group stage or knockout match odds
- Comparing sportsbook vs prediction market prices for World Cup outcomes
- Tournament favorites, dark horses, or underdogs
- World Cup betting value or price discrepancies

# Operations

### 1. Outright Winner Futures

Fetch which teams are favored to win the 2026 World Cup across all sportsbooks:

```bash
curl -s "https://api.the-odds-api.com/v4/sports/soccer_fifa_world_cup_winner/odds?apiKey=$ODDS_API_KEY&regions=us&markets=outrights&oddsFormat=american" \
  | jq '[.[] | {
    market: .away_team // "Outright Winner",
    books: [.bookmakers[] | {
      name: .title,
      selections: [.markets[0].outcomes[] | {team: .name, odds: .price}] | sort_by(.odds) | reverse
    }]
  }] | .[0].books[0].selections[:15] | map({team, odds, implied_prob: (if .odds > 0 then (100 / (.odds + 100) * 100 | round / 100) else (-.odds / (-.odds + 100) * 100 | round / 100) end)})'
```

If the outrights market is not yet available, try the standard futures endpoint:

```bash
curl -s "https://api.the-odds-api.com/v4/sports/soccer_fifa_world_cup/odds?apiKey=$ODDS_API_KEY&regions=us&markets=outrights&oddsFormat=american" \
  | jq '[.[0].bookmakers[] | {
    book: .title,
    top_5: [.markets[0].outcomes | sort_by(.price) | reverse | .[:5][] | {team: .name, odds: .price}]
  }]'
```

### 2. Group Stage Match Odds

Fetch moneylines and totals for upcoming World Cup group stage matches:

```bash
curl -s "https://api.the-odds-api.com/v4/sports/soccer_fifa_world_cup/odds?apiKey=$ODDS_API_KEY&regions=us&markets=h2h,totals,draw_no_bet&oddsFormat=american" \
  | jq '[.[] | {
    match: "\(.away_team) vs \(.home_team)",
    kickoff: .commence_time,
    books: [.bookmakers[:5][] | {
      name: .title,
      h2h: (.markets[] | select(.key=="h2h") | .outcomes | map({(.name): .price}) | add) // null,
      total: (.markets[] | select(.key=="totals") | .outcomes | map({(.name): "\(.point) (\(.price))"}) | add) // null
    }]
  }]'
```

### 3. Knockout Match Odds

Same as group stage but filtered for matches with only two outcomes relevant (draw less likely to be the focus):

```bash
curl -s "https://api.the-odds-api.com/v4/sports/soccer_fifa_world_cup/odds?apiKey=$ODDS_API_KEY&regions=us&markets=h2h,spreads,totals&oddsFormat=american" \
  | jq '[.[] | {
    match: "\(.away_team) vs \(.home_team)",
    kickoff: .commence_time,
    books: [.bookmakers[:5][] | {
      name: .title,
      h2h: (.markets[] | select(.key=="h2h") | .outcomes | map({(.name): .price}) | add) // null,
      spread: (.markets[] | select(.key=="spreads") | .outcomes | map({(.name): "\(.point) (\(.price))"}) | add) // null,
      total: (.markets[] | select(.key=="totals") | .outcomes | map({(.name): "\(.point) (\(.price))"}) | add) // null
    }]
  }]'
```

### 4. Polymarket World Cup Comparison

Fetch World Cup prediction market prices from Polymarket and display alongside sportsbook implied probabilities:

```bash
curl -s "https://gamma-api.polymarket.com/events?tag=world-cup&closed=false&limit=10" \
  | jq '[.[] | {
    question: .title,
    outcomes: [.markets[]? | {
      question: .question,
      outcomes: [.outcomes[]? | {name: .value, price: .price}]
    }]
  }]'
```

For a broader search if the tag filter returns empty:

```bash
curl -s "https://gamma-api.polymarket.com/events?tag=soccer&closed=false&limit=20" \
  | jq '[.[] | select(.title | test("World Cup|FIFA|2026"; "i")) | {
    question: .title,
    end_date: .endDate,
    markets: [.markets[]? | {
      question: .question,
      outcomes: [.outcomes[]? | {name: .value, price: .price}]
    }]
  }]'
```

### 5. Tournament Dashboard — Unified View

Combine sportsbook futures with Polymarket prices. Run this as a two-step pipeline:

Step 1 — Get top 10 sportsbook favorites:

```bash
curl -s "https://api.the-odds-api.com/v4/sports/soccer_fifa_world_cup_winner/odds?apiKey=$ODDS_API_KEY&regions=us&markets=outrights&oddsFormat=american" \
  | jq '[.[0].bookmakers[0].markets[0].outcomes | sort_by(.price) | reverse | .[:10][] | {
    team: .name,
    best_american_odds: .price,
    sportsbook_implied: (if .price > 0 then (100 / (.price + 100) * 100 | round) / 100 else ((-.price) / ((-.price) + 100) * 100 | round) / 100 end)
  }]'
```

Step 2 — Get Polymarket winner market and display side-by-side:

```bash
curl -s "https://gamma-api.polymarket.com/events?tag=world-cup&closed=false&limit=5" \
  | jq '[.[] | select(.title | test("winner|champion"; "i")) | .markets[]? | .outcomes[]? | {
    team: .value,
    polymarket_price: .price
  }] | sort_by(-.polymarket_price) | .[:10]'
```

Present both results in a single table with columns: Team, Sportsbook Odds, Sportsbook Implied %, Polymarket Price, and Delta (difference between the two implied probabilities).

# Output Rules

1. Always show the team name and implied probability when presenting futures
2. For match odds, show American odds format and kickoff time
3. When comparing sportsbook vs Polymarket, compute the delta between implied probabilities
4. Highlight any team where the delta exceeds 3 percentage points — these are potential value spots
5. If the World Cup sport key returns empty results, inform the user that markets may not be posted yet
6. Always report remaining API quota after a request
7. Note that sportsbook implied probabilities include vig — Polymarket prices are generally closer to true probability

# Error Handling

- If ODDS_API_KEY is not set, tell the user to get a free key at https://the-odds-api.com/
- If the API returns an empty array for soccer_fifa_world_cup_winner, try soccer_fifa_world_cup instead — market availability depends on how far out from the tournament
- If Polymarket returns no World Cup markets, note that prediction markets may not have listed World Cup events yet
- If rate limited (429), report remaining quota and suggest waiting
- After the tournament ends (August 2026), both APIs will stop returning World Cup data — inform the user the skill is dormant until the next major tournament

export ODDS_API_KEY=your_key_here

echo 'export ODDS_API_KEY=your_key_here' >> ~/.zshrc

{
  "cron": "0 9 * * *",
  "prompt": "Run the World Cup tournament dashboard. If any team's implied probability has moved more than 3 points from yesterday, alert me on Telegram with the team, old price, new price, and direction."
}

{
  "cron": "0 */2 * * *",
  "prompt": "Check World Cup match odds for today's games. If any moneyline has moved more than 20 cents since the last check, alert me."
}