List Games

Games for a league with scores, teams, market data, token IDs, and upstream fallback metadata.

GET /v2/sports/leagues/{code}/games

List Games

cURL

curl --request GET \
  --url https://api.polynode.dev/v2/sports/leagues/{code}/games \
  --header 'x-api-key: <api-key>'

{
  "league": "fifwc",
  "status": "active",
  "series_id": "11433",
  "source": "gamma:/events",
  "fallback": false,
  "stale": false,
  "count": 2,
  "games": [
    {
      "id": "351718",
      "slug": "fifwc-usa-par-2026-06-12",
      "title": "United States vs. Paraguay",
      "startTime": "2026-06-13T01:00:00Z",
      "eventDate": "2026-06-12",
      "closed": false,
      "status": "scheduled",
      "markets": [
        {
          "id": "1897039",
          "question": "Will United States win on 2026-06-12?",
          "sportsMarketType": "moneyline",
          "outcomes": ["Yes", "No"],
          "outcomePrices": ["0.385", "0.615"],
          "clobTokenIds": ["...", "..."],
          "_links": {
            "ws": "wss://ws.polynode.dev/ws",
            "ws_subscribe": {
              "action": "subscribe",
              "type": "orderbook",
              "token_ids": ["...", "..."]
            },
            "orderbook_rest": "https://api.polynode.dev/v1/orderbook/..."
          }
        }
      ]
    }
  ]
}

Returns daily matchups for a league. Use status=closed to get completed games with final scores.

The endpoint resolves the league code to Polymarket’s sports series ID, fetches game events by series_id, and applies status filtering, sorting, limit, and offset in PolyNode. This avoids Polymarket Gamma outages in tag and filtered pagination queries. If the primary Gamma event listing is unavailable, PolyNode falls back to alternate Gamma series/event sources and marks fallback: true. If all upstream sources fail but a recent good response exists, PolyNode returns that response with stale: true.

code · string · required

League code from /v2/sports/leagues (for example fifwc, fif, nba, lol, cs2).

key · string · required

Your API key.

status · string · default: "active"

active for upcoming/in-progress games, closed for completed games with scores.

limit · integer · default: "50"

Max results per page (1-200).

offset · integer · default: "0"

Pagination offset.

sort · string · default: "startDate"

Sort by startDate or volume.

direction · string · default: "desc"

asc or desc.

league · string

Requested league code.

status · string

Applied status filter, either active or closed.

series_id · string

Polymarket Gamma sports series ID used for discovery.

source · string

Upstream source used for this response, such as gamma:/events, gamma:/series/{id}, or gamma:/events/pagination.

fallback · boolean

true when PolyNode used an alternate Gamma source after the primary event listing was unavailable or unsuitable.

stale · boolean

true when PolyNode served the last-known-good response because all upstream Gamma sources failed.

{
  "league": "fifwc",
  "status": "active",
  "series_id": "11433",
  "source": "gamma:/events",
  "fallback": false,
  "stale": false,
  "count": 2,
  "games": [
    {
      "id": "351718",
      "slug": "fifwc-usa-par-2026-06-12",
      "title": "United States vs. Paraguay",
      "startTime": "2026-06-13T01:00:00Z",
      "eventDate": "2026-06-12",
      "closed": false,
      "status": "scheduled",
      "markets": [
        {
          "id": "1897039",
          "question": "Will United States win on 2026-06-12?",
          "sportsMarketType": "moneyline",
          "outcomes": ["Yes", "No"],
          "outcomePrices": ["0.385", "0.615"],
          "clobTokenIds": ["...", "..."],
          "_links": {
            "ws": "wss://ws.polynode.dev/ws",
            "ws_subscribe": {
              "action": "subscribe",
              "type": "orderbook",
              "token_ids": ["...", "..."]
            },
            "orderbook_rest": "https://api.polynode.dev/v1/orderbook/..."
          }
        }
      ]
    }
  ]
}

How to get scores

# Get last night's NBA results with scores
curl "https://api.polynode.dev/v2/sports/leagues/nba/games?status=closed&limit=10&key=YOUR_KEY"

# Get upcoming World Cup matches in kickoff order
curl "https://api.polynode.dev/v2/sports/leagues/fifwc/games?status=active&sort=startDate&direction=asc&limit=50&key=YOUR_KEY"

# Get upcoming NHL games
curl "https://api.polynode.dev/v2/sports/leagues/nhl/games?status=active&limit=20&key=YOUR_KEY"

Each game has an event id and a slug, while every nested market has its own market id. Use any of them with the Game Detail endpoint to get full team info, all markets, and AI-generated game previews. Event-ID and market-ID lookups use the explicit /by-event/{event_id} and /by-market/{market_id} paths documented there.

Esports score format

Esports scores use a different format than traditional sports:

Sport	Score format	Example
NBA, NHL, MLB	home-away	94-111
LoL, CS2, Valorant	mapScores|seriesScore|format	000-000|2-0|Bo3

Only returns daily matchups, not season-long futures (MVP, Champion, etc.). If you need futures markets, use the Event Detail endpoint.

Authorizations

x-api-key · string · header · required

Path Parameters

code · string · default: nba · required

League code (e.g. fifwc, fif, nba, lol, cs2)

Query Parameters

status · enum<string> · default: active

active or closed

Available options: active, closed

limit · integer · default: 50

Max results (1-200)

offset · integer · default: 0

Pagination offset

sort · enum<string> · default: startDate

Sort field

Available options: startDate, volume

direction · enum<string> · default: desc

Sort direction

Available options: asc, desc

Response

200

Game list. Top-level fields include league, status, series_id, source, fallback, stale, count, and games.