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.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
bet | integer | No | Filter by bet ID returned by the odds bets endpoint. | — |
date | string | No | Filter 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. | — |
page | integer | No | Pagination page number. Start with 1. | — |
league | integer | No | Filter 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. | — |
season | integer | No | Season 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. | — |
fixture | integer | No | Filter 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. | — |
timezone | string | No | Timezone name, for example Europe/London, used with date-based odds queries. | — |
bookmaker | integer | No | Filter 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-KeyRequest 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
{
"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.

