GET /events - Fetch Games, Odds, and Results

Get a list of Events

GET https://api.sockodds.com/v2/events/

Retrieve sports events with odds, status, teams, players, results and bookmaker links. Filter by league, team, date or odds market. Includes every bookmaker line your plan allows.

Query parameters

Response

Paginated: { "success": true, "data": Event[], "nextCursor": string | null, "notice": string? }

Event

Contains basic information, consensus odds, results (stats & scores), team info, lineups and bookmaker links for a given event/game

Status codes

Example response

Trimmed to one market; see the quickstart for a full event.

{
  "success": true,
  "nextCursor": "afl_2026-09-03_fremantle_vs_hawthorn",
  "data": [
    {
      "eventID": "afl_2026-09-03_fremantle_vs_hawthorn",
      "sportID": "AUSSIE_RULES",
      "leagueID": "AFL",
      "type": "match",
      "status": {
        "started": false,
        "ended": false,
        "live": false,
        "cancelled": false,
        "finalized": false,
        "oddsPresent": true,
        "oddsAvailable": true
      },
      "info": {
        "stale": false
      },
      "odds": {
        "points-all-game-eo-odd": {
          "oddID": "points-all-game-eo-odd",
          "opposingOddID": "points-all-game-eo-even",
          "marketName": "Odd/Even Total Points",
          "statID": "points",
          "statEntityID": "all",
          "periodID": "game",
          "betTypeID": "eo",
          "sideID": "odd",
          "bookOdds": "-116",
          "fairOdds": null,
          "bookOverUnder": null,
          "bookSpread": null,
          "byBookmaker": {
            "unibet": {
              "bookmakerID": "unibet",
              "odds": "-115",
              "decimal": 1.87,
              "available": true,
              "lastUpdatedAt": "2026-09-03T10:22:09.000Z"
            },
            "tabtouch": {
              "bookmakerID": "tabtouch",
              "odds": "-118",
              "decimal": 1.85,
              "available": true,
              "lastUpdatedAt": "2026-09-03T10:21:03.000Z"
            }
          }
        }
      }
    }
  ]
}

Code samples

curl -X GET "https://api.sockodds.com/v2/events/?leagueID=AFL&oddsAvailable=true&limit=1" \
  -H "x-api-key: YOUR_API_KEY"

const r = await fetch("https://api.sockodds.com/v2/events/?leagueID=AFL&oddsAvailable=true&limit=1", { headers: { "x-api-key": "YOUR_API_KEY" } });
const { success, data, nextCursor, notice } = await r.json();

import requests
r = requests.get("https://api.sockodds.com/v2/events/", params=dict(leagueID="AFL", oddsAvailable="true", limit="1"), headers={"x-api-key": "YOUR_API_KEY"})
body = r.json()

req, _ := http.NewRequest("GET", "https://api.sockodds.com/v2/events/?leagueID=AFL&oddsAvailable=true&limit=1", nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)

HttpRequest req = HttpRequest.newBuilder().uri(URI.create("https://api.sockodds.com/v2/events/?leagueID=AFL&oddsAvailable=true&limit=1"))
    .header("x-api-key", "YOUR_API_KEY").GET().build();
HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var body = await http.GetStringAsync("https://api.sockodds.com/v2/events/?leagueID=AFL&oddsAvailable=true&limit=1");

Try it

// the response appears here