Markets Orchestration

Bridges ESPN live schedules (NBA, NFL, MLB, NHL, WNBA, CFB, CBB) with Kalshi and Polymarket prediction markets.

Quick Start

# Today's games with matching prediction markets
sports-skills markets get_todays_markets --sport=nba

# Search for a team across both exchanges
sports-skills markets search_entity --query="Lakers"

# Compare ESPN odds vs prediction market prices for a game
sports-skills markets compare_odds --sport=nba --event_id=401234567

# Sports-filtered market listing (no political/weather noise)
sports-skills markets get_sport_markets --sport=nfl

# Unified ESPN schedule
sports-skills markets get_sport_schedule --sport=nba

# Normalize a price from any source
sports-skills markets normalize_price --price=0.65 --source=polymarket

# Full evaluation: ESPN odds + market price → devig → edge → Kelly
sports-skills markets evaluate_market --sport=nba --event_id=401234567

Python SDK:

from sports_skills import markets

markets.get_todays_markets(sport="nba")
markets.search_entity(query="Lakers")
markets.compare_odds(sport="nba", event_id="401234567")
markets.get_sport_markets(sport="nfl")
markets.get_sport_schedule(sport="nba", date="2025-02-26")
markets.normalize_price(price=0.65, source="polymarket")
markets.evaluate_market(sport="nba", event_id="401234567")

Commands

Supported Sports

Workflows

Today’s NBA Dashboard

Show all NBA games today with matching prediction market odds.

sports-skills markets get_todays_markets --sport=nba

Returns each game with:

• ESPN game info (teams, time, status)
• ESPN DraftKings odds (American format)
• Matching Kalshi markets (scoped to KXNBA series)
• Matching Polymarket markets (text search, sports-filtered)

Find Arb on a Specific Game

1. Get the ESPN event ID from the schedule: sports-skills markets get_sport_schedule --sport=nba
2. Compare odds across all sources: sports-skills markets compare_odds --sport=nba --event_id=401234567
3. If arbitrage is detected, the response includes allocation percentages and guaranteed ROI.

Compare ESPN vs Polymarket

1. sports-skills markets compare_odds --sport=nba --event_id=401234567
2. Response includes ESPN odds normalized to probability + Polymarket prices side-by-side
3. Arbitrage check runs automatically using betting.find_arbitrage

Full Bet Evaluation

1. sports-skills markets evaluate_market --sport=nba --event_id=401234567
2. Fetches ESPN odds, searches for matching prediction market price
3. Pipes through betting.evaluate_bet: devig → edge → Kelly
4. Returns fair probability, edge percentage, EV, Kelly fraction, and recommendation

Search for a Team

Find all prediction markets related to a team:

sports-skills markets search_entity --query="Chiefs" --sport=nfl

Returns Kalshi events (scoped to KXNFL) and Polymarket markets matching “Chiefs”.

Price Normalization

Different sources use different formats:

normalize_price converts any format to a common structure:

{
  "implied_probability": 0.65,
  "american": -185.7,
  "decimal": 1.5385,
  "source": "polymarket"
}

Examples

User: “What NBA games are on today and what are the prediction market odds?” → markets.get_todays_markets(sport="nba")

User: “Find me Lakers markets on Kalshi and Polymarket” → markets.search_entity(query="Lakers", sport="nba")

User: “Compare the odds for this Celtics game across ESPN and Polymarket” → markets.compare_odds(sport="nba", event_id="<id>")

User: “Is there edge on the Chiefs game?” → markets.evaluate_market(sport="nfl", event_id="<id>")

User: “Show me all NFL prediction markets” → markets.get_sport_markets(sport="nfl")

User: “Convert a Polymarket price of 65 cents to American odds” → markets.normalize_price(price=0.65, source="polymarket")

Partial Results

If one source is unavailable (e.g., Kalshi is down), the module returns what it has with warnings:

{
  "status": true,
  "data": {
    "games": [...],
    "warnings": ["Kalshi search failed: connection timeout"]
  }
}

This ensures you always get usable data even when a source is temporarily unavailable.