Skip to main content
GET
/
exchange
/
v2
/
getGames
Get games
curl --request GET \
  --url https://api.4casters.io/exchange/v2/getGames \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "games": [
      {
        "id": "<string>",
        "parentGameID": "<string>",
        "cheapDataUID": "<string>",
        "league": "<string>",
        "sport": "<string>",
        "start": "2023-11-07T05:31:56Z",
        "ended": true,
        "live": true,
        "featured": true,
        "eventName": "<string>",
        "tournamentName": "<string>",
        "periodName": "<string>",
        "isSpecials": true,
        "participants": [
          {
            "id": "<string>",
            "longName": "<string>",
            "shortName": "<string>",
            "mainPitcher": "<string>",
            "rotationNumber": "<string>",
            "futuresSide": "<string>",
            "score": 123
          }
        ]
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.4casters.io/llms.txt

Use this file to discover all available pages before exploring further.

Returns all active games for a league. The response does not include the orderbook or any prices — call Get orderbook for that.

​
Request

GET /exchange/v2/getGames
​
league
string
required
League code from Get leagues. Use the special value upcoming to get all upcoming games across leagues.
​
sport
string
Optional sport filter.
curl "https://api.4casters.io/exchange/v2/getGames?league=NBA" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

​
data.games
array

​
Example

{
  "data": {
    "games": [
      {
        "id": "6266c12172aefcf0033374ce",
        "parentGameID": null,
        "cheapDataUID": "32620-79238-2022-04-26",
        "league": "NHL",
        "sport": "hockey",
        "start": "2022-04-26T18:00:00.000Z",
        "ended": false,
        "live": false,
        "featured": false,
        "participants": [
          { "id": "60747bc471b5071a80ca0ac8", "longName": "Carolina Hurricanes", "shortName": "CAR", "homeAway": "away", "mainPitcher": null, "rotationNumber": "25", "futuresSide": "" },
          { "id": "607349daf6d3364eb69604f6", "longName": "New York Rangers",    "shortName": "NEW", "homeAway": "home", "mainPitcher": null, "rotationNumber": "26", "futuresSide": "" }
        ]
      }
    ]
  }
}

​
Errors

StatusMeaning
400league is required.

Authorizations

​
Authorization
string
header
required

Pass your auth token in the Authorization header. The Bearer prefix is optional; the server also accepts a signed auth cookie or a token field in the request body.

Query Parameters

​
league
string
required

League code from GET /exchange/getLeagues. Use upcoming for all upcoming games across leagues.

​
sport
string

Optional sport filter.

Response

Games list

​
data
object