Soccer API for Scores, Odds & AI Agents

Available data

Filter with sport=soccer and a league slug when you care about one competition. Discover seasons with GET /v1/seasons?sport=soccer.

Leagues

One page, many slugs. Use league= to narrow; omit it to list across soccer.

/stats is soccer-native across these competitions when aggregates resolve.

Schedules

GET /v1/events?sport=soccer — add league=mls (or epl, …). Narrow by status, date or from/to (max 90 days/request), paginate with after_id / limit.

Compound with include_odds=true / include_scores=true for matchday boards in one round trip.

Scores

Soccer period labels: "1H", "2H", "ET1", "ET2", "PKs". Clock examples: "45'+2", "67'".

• GET /v1/events?sport=soccer&status=inprogress&include_scores=true
• GET /v1/events/{id}/score — lightweight poll
• GET /v1/events/{id}/stream — SSE or signed webhooks

Demo: live scoreboard use case.

Odds

Soccer moneyline is 3-way: home, away, and Draw under h2h. Spreads use Asian-style goal lines (e.g. -0.5 / +0.5). Totals are Over/Under. Default Pinnacle or bookmaker=all = 1 credit.

Player props: goals, assists, shots on target, and fouls committed — catalog. Soccer /odds stays 3-way moneyline / Asian handicap / totals. History: GET /v1/events/{id}/odds/history. Full books: Sports Odds API.

Stats (Data layer)

GET /v1/events/{id}/stats returns soccer-native team aggregates (strength, form, H2H, rest, rates, lineups). No confidence or narrative. Check available. Fields: API reference — stats.

Intelligence

• MLS + big-five (EPL, La Liga, Serie A, Bundesliga, Ligue 1) — customer probability surface + Price overlay (probability / fair_price + fair / edges_by_book / best vs Pinnacle) and main-line ev (Beta). Outcomes in a market sum to 1. Framework plumbing omitted. best.edge is a line-shopping price gap vs Pinnacle. has_recommend stays false until Edge publishes.
• UCL — schedules, scores, odds, and /stats today; intelligence returns available: false.

Tokens: ML_HOME, ML_AWAY, ML_DRAW, SPREAD_HOME, SPREAD_AWAY, OVER, UNDER.

Sportsbooks

Odds keys: pinnacle, fanduel, draftkings, betmgm, caesars, bet365, circa, westgate, wynn, south_point, stations, hardrock, betonline, betr, betrivers, lowvig. Bovada is not on soccer. Per-event availability varies — especially on EU club fixtures. MLS Price soft set is narrower than the full odds list; always read the payload.

Examples

MLS slate with odds:

curl "https://lumify.ai/v1/events?sport=soccer&league=mls&status=scheduled&include_odds=true&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

from lumify import Lumify

client = Lumify(api_key="YOUR_API_KEY")
page = client.events.list(
    sport="soccer",
    league="mls",
    status="scheduled",
    include_odds=True,
    limit=5,
)
for event in page["events"]:
    print(event["id"], event["name"])

import { Lumify } from "@lumifyai/sdk";

const client = new Lumify({ apiKey: "YOUR_API_KEY" });
const { events } = await client.events.list({
  sport: "soccer",
  league: "mls",
  status: "scheduled",
  includeOdds: true,
  limit: 5,
});
events.forEach(e => console.log(e.id, e.name));

Premier League weekend board:

curl "https://lumify.ai/v1/events?sport=soccer&league=epl&status=scheduled&include_odds=true&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

epl = client.events.list(
    sport="soccer",
    league="epl",
    status="scheduled",
    include_odds=True,
    limit=10,
)

const { events: epl } = await client.events.list({
  sport: "soccer",
  league: "epl",
  status: "scheduled",
  includeOdds: true,
  limit: 10,
});

Sample 3-way moneyline (abridged):

{
  "event_id": 9201,
  "available": true,
  "bookmakers": [
    {
      "bookmaker": "pinnacle",
      "markets": [
        {
          "key": "h2h",
          "label": "moneyline",
          "outcomes": [
            { "outcome": "Inter Miami CF", "price": 145, "point": null },
            { "outcome": "Draw", "price": 240, "point": null },
            { "outcome": "LAFC", "price": 175, "point": null }
          ]
        }
      ],
      "captured_at": "2026-08-10T18:00:00Z"
    }
  ]
}

Freshness

Pricing

Free Tier: 1,000 credits that never expire. Instant trial: 100 credits / 14 days, no signup. Details: /pricing.