API Sports Football Get Odds

1 credits/call
ae_api_sports_football_get_odds

Get pre-match football odds. Specify a target fixture, a date, or a league and season; filtered queries may have no available odds.

Entertainment
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
betintegerNoFilter by bet ID returned by the odds bets endpoint.—
datestringNoFilter by fixture date in YYYY-MM-DD format. This is a primary query selector; use a real target date. Odds coverage is time-sensitive and an empty result is possible.—
pageintegerNoPagination page number. Start with 1.—
leagueintegerNoFilter by a real league ID. For a league query, pair league with the corresponding season; do not send an empty object or invent league IDs.—
seasonintegerNoSeason year for the selected league. Pair with league for league-level odds queries; prefer the active/current season. Older seasons may validly return no odds.—
fixtureintegerNoFilter by a real fixture ID resolved from the fixtures endpoint. This is a primary query selector; provide a meaningful filter rather than an empty object. Older fixtures may validly have no available odds.—
timezonestringNoTimezone name, for example Europe/London, used with date-based odds queries.—
bookmakerintegerNoFilter by bookmaker ID returned by the odds bookmakers endpoint.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_api_sports_football_get_odds' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "bet": 1,
    "bookmaker": 3,
    "fixture": 1557411
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "errors": [],
  "get": "odds",
  "paging": {
    "current": 1,
    "total": 1
  },
  "parameters": {
    "bet": "1",
    "bookmaker": "3",
    "fixture": "1557411"
  },
  "response": [
    {
      "bookmakers": [
        {
          "bets": [
            {}
          ],
          "id": 3,
          "name": "Betfair"
        }
      ],
      "fixture": {
        "date": "2026-09-20T15:30:00+00:00",
        "id": 1557411,
        "timestamp": 1789918200,
        "timezone": "UTC"
      },
      "league": {
        "country": "England",
        "flag": "https://media.api-sports.io/flags/gb-eng.svg",
        "id": 39,
        "logo": "https://media.api-sports.io/football/leagues/39.png",
        "name": "Premier League",
        "season": 2026
      },
      "update": "2026-09-20T09:29:17+00:00"
    }
  ],
  "results": 1
}

This example shows part of the response. Copied content is valid JSON.