OddsPapi

https://oddspapi.io/us/docs
Admin
OddsPapi Sports Odds API provides real-time sports data, including live betting odds, pre-match...
Tokens:34,007
Snippets:158
Trust Score:6.5
Update:3 months ago
Show doc for...
Tokens:
Raw
### Example GET Participants Request

Source: https://oddspapi.io/us/docs/get-participants

An example of a request to the participants endpoint, specifying the sport ID and language.

```bash
GET /v4/participants?sportId=11&language=en
```

--------------------------------

### GET /v4/fixtures Request Example

Source: https://oddspapi.io/us/docs/get-fixtures

Example of a GET request to retrieve fixtures with specific filters for sport, date range, status, and bookmakers. Ensure parameters like sportId, from, and to are correctly formatted.

```http
GET /v4/fixtures?sportId=10&from=2026-04-12&to=2026-04-17&statusId=0&hasOdds=true&bookmakers=pinnacle
```

--------------------------------

### Example GET Participants Response

Source: https://oddspapi.io/us/docs/get-participants

A sample JSON response for the GET participants endpoint, showing participant IDs and their corresponding names.

```json
{
  "3409": "Chicago Bulls",
  "3410": "Milwaukee Bucks"
}
```

--------------------------------

### GET /v4/fixtures Response Example

Source: https://oddspapi.io/us/docs/get-fixtures

Example JSON response for the GET /v4/fixtures endpoint, showing a single fixture object with detailed information including IDs, names, status, and external provider references. This structure is returned when the request is successful.

```json
[
  {
    "fixtureId": "id1000001761301153",
    "participant1Id": 35,
    "participant2Id": 34,
    "sportId": 10,
    "tournamentId": 17,
    "seasonId": 130281,
    "statusId": 0,
    "hasOdds": true,
    "startTime": "2026-04-13T19:00:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2026-04-06T23:17:08.202Z",
    "externalProviders": {
      "betradarId": 61301153,
      "mollybetId": "2026-04-13,35,34",
      "opticoddsId": "20260413A1B2C3D4",
      "lsportsId": null,
      "txoddsId": null,
      "sofascoreId": 15676100,
      "betgeniusId": 13670012,
      "flashscoreId": "xK4pLm2n",
      "pinnacleId": 1626291706,
      "oddinId": null
    },
    "statusName": "Pre-Game",
    "participant1Name": "Liverpool FC",
    "participant1ShortName": "Liverpool",
    "participant1Abbr": "LIV",
    "participant2Name": "Manchester United",
    "participant2ShortName": "Man Utd",
    "participant2Abbr": "MNU",
    "sportName": "Soccer",
    "tournamentSlug": "premier-league",
    "categorySlug": "england",
    "categoryName": "England",
    "tournamentName": "Premier League"
  }
]
```

--------------------------------

### Example Account Response

Source: https://oddspapi.io/us/docs/get-account

This is an example of the JSON response you will receive when calling the GET /v4/account endpoint. It includes details about your API key, subscription, and usage.

```json
{
  "api_key": "Fdgvr5S28-bSRY5d-JV8yBYc-UJGWwwQPqG",
  "created_at": "2025-07-14T13:29:48.525Z",
  "language_code": "en",
  "language_name": "English",
  "current_subscription_id": "v6ZgCuxA-gMTn5Bd-nKPPvkycUK-xgmNehB",
  "subscriptions": [
    {
      "subscription_id": "v6ZgCuxA-gMTn5Bd-nKPPvkycUK-xgmNehB",
      "currency": "USD",
      "price": null,
      "valid_from": "2025-07-16T13:25:00.647Z",
      "valid_until": null,
      "auto_renew": false,
      "is_active": true,
      "created_at": "2025-07-16T13:25:00.647Z",
      "bookmakers": {
        "pinnacle": {
          "has_live_odds": false,
          "has_player_props": false
        }
      },
      "sport_ids": [
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "websocket_access": 0,
      "request_limit": 500,
      "rate_limit": null,
      "request_count": 100,
      "last_request": "2025-07-16T13:25:00.647Z"
    }
  ]
}
```

--------------------------------

### GET Settlements Endpoint Example Request

Source: https://oddspapi.io/us/docs/get-settlements

This is an example of how to request settlement data for a specific fixture. Ensure you replace 'id1000000761280685' with a valid fixture ID.

```bash
**GET** /v4/settlements?fixtureId=id1000000761280685
```

--------------------------------

### GET Markets Endpoint Example

Source: https://oddspapi.io/us/docs/get-markets

Use this endpoint to retrieve a list of markets available in the system. You can optionally specify the language for the returned information.

```http
GET /v4/markets?language=en
```

--------------------------------

### GET Odds Endpoint Example Request

Source: https://oddspapi.io/us/docs/get-odds

Use this example to retrieve odds for a specific fixture, filtering by bookmaker and language, with a verbosity level of 3.

```http
**GET** /v4/odds?fixtureId=id1000003969653792&bookmakers=pinnacle&language=en&verbosity=3
```

--------------------------------

### Get Tournaments for a Sport (cURL)

Source: https://oddspapi.io/us/docs

Example using cURL to fetch tournaments for a given sport ID. Replace {{YOUR_API_KEY}} with your actual API key.

```bash
curl "https://api.oddspapi.io/v4/tournaments?sportId=10&apiKey={{YOUR_API_KEY}}"
```

--------------------------------

### Example Response for GET Scores

Source: https://oddspapi.io/us/docs/get-scores

This is a sample JSON response for the GET /v4/scores endpoint, illustrating the structure of scores broken down by period.

```json
{
  "fixtureId": "id65236323277832",
  "scores": {
    "0": {
      "participant1Score": 0,
      "participant2Score": 2,
      "updatedAt": "2025-07-07T19:23:40.558913+00:00"
    },
    "1": {
      "participant1Score": 3,
      "participant2Score": 6,
      "updatedAt": "2025-07-07T18:32:58.060019+00:00"
    },
    "2": {
      "participant1Score": 5,
      "participant2Score": 7,
      "updatedAt": "2025-07-07T19:23:40.558913+00:00"
    },
    "3": {
      "participant1Score": 2,
      "participant2Score": 2,
      "updatedAt": "2025-07-07T19:53:03.905144+00:00"
    }
  }
}
```

--------------------------------

### Example Response for GET /v4/sports

Source: https://oddspapi.io/us/docs/get-sports

A successful response (200 OK) returns a JSON array of sport objects, each containing sportId, slug, and sportName.

```json
[
  {
    "sportId": 10,
    "slug": "soccer",
    "sportName": "Soccer"
  },
  {
    "sportId": 11,
    "slug": "basketball",
    "sportName": "Basketball"
  }
]
```

--------------------------------

### GET /v4/sports Request with Language Parameter

Source: https://oddspapi.io/us/docs/get-sports

Example of how to request sports data in a specific language using the 'language' query parameter.

```bash
**GET** /v4/sports?language=en
```

--------------------------------

### Multiple Market Update Example

Source: https://oddspapi.io/us/docs/websocket-api

Example showing updates for multiple markets within a single bookmaker's odds.

```json
{
  "fixtureId": "id1001509158796975",
  "bookmakerOdds": {
    "stake": {
      "markets": {
        "101": {
          "outcomes": {
            "101": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "2535416646",
                  "changedAt": "2025-06-11T16:55:30.284055+00:00",
                  "limit": null,
                  "playerName": null,
                  "price": 1.345,
                  "exchangeMeta": {},
                  "playerId": 0
                }
              }
            },
            "102": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "2535416646",
                  "changedAt": "2025-06-11T16:55:30.284055+00:00",
                  "limit": null,
                  "playerName": null,
                  "price": 1.345,
                  "exchangeMeta": {},
                  "playerId": 0
                }
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Bookmaker Info Update Example

Source: https://oddspapi.io/us/docs/websocket-api

Example of a message providing bookmaker-specific fixture details and paths.

```json
{
  "fixtureId": "id1100023561139799",
  "bookmakerOdds": {
    "22bet": {
      "bookmakerFixtureId": "265591179",
      "fixturePath": "https://22bets.com/line/basketball/5226-e/265591179-kk-partizan-buducnost-podgorica"
    }
  }
}
```

--------------------------------

### Player Odds Update Example

Source: https://oddspapi.io/us/docs/websocket-api

Example of a message updating player-specific odds information.

```json
{
  "fixtureId": "id1100097561092987",
  "bookmakerOdds": {
    "starcasino.be": {
      "markets": {
        "111": {
          "outcomes": {
            "111": {
              "players": {
                "0": {
                  "active": true,
                  "betslip": null,
                  "bookmakerOutcomeId": "2535416646",
                  "changedAt": "2025-06-11T16:55:30.284055+00:00",
                  "limit": null,
                  "playerName": null,
                  "price": 1.345,
                  "exchangeMeta": {},
                  "playerId": 0
                }
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### GET Scores Endpoint Example

Source: https://oddspapi.io/us/docs/get-scores

This example shows how to request score breakdowns for a specific fixture using its ID. Ensure you replace 'id65236323277832' with a valid fixture ID.

```http
GET /v4/scores?fixtureId=id65236323277832
```

--------------------------------

### GET Settlements Example Response

Source: https://oddspapi.io/us/docs/get-settlements

This JSON object shows the structure of the response when successfully retrieving settlement data. It includes fixture ID, market details, and the result for each player's outcome.

```json
{
  "fixtureId": "id1000000761280685",
  "markets": {
    "101": {
      "outcomes": {
        "101": {
          "players": {
            "0": {
              "result": "WIN"
            }
          }
        },
        "102": {
          "players": {
            "0": {
              "result": "LOSE"
            }
          }
        },
        "103": {
          "players": {
            "0": {
              "result": "LOSE"
            }
          }
        }
      }
    },
    "106": {
      "outcomes": {
        "106": {
          "players": {
            "0": {
              "result": "WIN"
            }
          }
        },
        "107": {
          "players": {
            "0": {
              "result": "LOSE"
            }
          }
        }
      }
    },
    "1056": {
      "outcomes": {
        "1056": {
          "players": {
            "0": {
              "result": "PUSH"
            }
          }
        },
        "1057": {
          "players": {
            "0": {
              "result": "PUSH"
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Odds by Tournaments (cURL)

Source: https://oddspapi.io/us/docs

Example using cURL to fetch odds for multiple tournaments from a specific bookmaker. Ensure to replace placeholders with actual values.

```bash
curl "https://api.oddspapi.io/v4/odds-by-tournaments?bookmaker=pinnacle&tournamentIds=17,8&apiKey={{YOUR_API_KEY}}"
```

--------------------------------

### Event Metadata Update Example

Source: https://oddspapi.io/us/docs/websocket-api

Example of a message containing updates to event metadata like status and last updated time.

```json
{
  "fixtureId": "id2704726161008023",
  "statusId": 1,
  "updatedAt": "2025-06-11T16:55:28.415401+00:00"
}
```

--------------------------------

### Score Update Example

Source: https://oddspapi.io/us/docs/websocket-api

Example of a message containing score updates for specific periods of an event.

```json
{
  "fixtureId": "id1000085362245214",
  "scores": {
    "periods": {
      "2": {
        "participant1Score": 0,
        "participant2Score": 0,
        "updatedAt": "2025-07-23T16:56:37.122614+00:00"
      }
    }
  }
}
```

--------------------------------

### Get Settlements

Source: https://oddspapi.io/us/docs/methods/get-account

Retrieves settlement information for past fixtures.

```APIDOC
## GET /v4/settlements

### Description
Fetches settlement information for past fixtures, indicating the outcome and results.

### Method
GET

### Endpoint
/v4/settlements

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your unique API key for authentication.
- **fixtureIds** (string) - Required - A comma-separated list of fixture IDs for which to retrieve settlement data.

### Response
#### Success Response (200)
- An array of objects, where each object corresponds to a fixture and contains settlement details such as `settledAt`, `winnerParticipantId`, and `payout`.

#### Response Example
```json
[
  {
    "fixtureId": "id1000001764618978",
    "settledAt": "2025-12-09T10:00:00.000Z",
    "winnerParticipantId": 35,
    "payout": {
      "101": 1.649, // Example for outcome 'away'
      "103": 1.649
    }
  }
]
```
```

--------------------------------

### Get Participants

Source: https://oddspapi.io/us/docs/methods/get-account

Retrieves a list of participants (teams or players) for fixtures.

```APIDOC
## GET /v4/participants

### Description
Retrieves a list of participants (teams or players) involved in fixtures. This can be filtered by sport or tournament.

### Method
GET

### Endpoint
/v4/participants

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your unique API key for authentication.
- **sportId** (integer) - Optional - Filter by sport ID.
- **tournamentId** (integer) - Optional - Filter by tournament ID.

### Response
#### Success Response (200)
- An array of participant objects, each containing `participantId`, `participantName`, and `participantSlug`.

#### Response Example
```json
[
  {
    "participantId": 3,
    "participantName": "Manchester United",
    "participantSlug": "manchester-united"
  },
  {
    "participantId": 35,
    "participantName": "Liverpool",
    "participantSlug": "liverpool"
  }
]
```
```

--------------------------------

### Get Markets

Source: https://oddspapi.io/us/docs/methods/get-account

Retrieves a list of available betting markets for fixtures.

```APIDOC
## GET /v4/markets

### Description
Fetches a list of all available betting market types offered by the API.

### Method
GET

### Endpoint
/v4/markets

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your unique API key for authentication.

### Response
#### Success Response (200)
- An array of market objects, each containing `marketId` and `marketName`.

#### Response Example
```json
[
  {
    "marketId": "101",
    "marketName": "Moneyline"
  },
  {
    "marketId": "104",
    "marketName": "Total"
  }
]
```
```

--------------------------------

### Get Fixtures

Source: https://oddspapi.io/us/docs/methods/get-account

Retrieves a list of upcoming, live, or completed fixtures based on various filters.

```APIDOC
## GET /v4/fixtures

### Description
Fetches a list of fixtures. You can filter by sport, tournament, bookmaker, and status.

### Method
GET

### Endpoint
/v4/fixtures

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your unique API key for authentication.
- **sportId** (integer) - Optional - Filter by sport ID.
- **tournamentIds** (string) - Optional - Filter by a comma-separated list of tournament IDs.
- **bookmakerIds** (string) - Optional - Filter by a comma-separated list of bookmaker IDs.
- **status** (string) - Optional - Filter by fixture status (e.g., 'live', 'finished', 'scheduled').
- **from** (string) - Optional - Filter fixtures starting from this date (YYYY-MM-DD).
- **to** (string) - Optional - Filter fixtures ending by this date (YYYY-MM-DD).

### Response
#### Success Response (200)
- An array of fixture objects, each containing details like `fixtureId`, `sportId`, `tournamentId`, `startTime`, `statusId`, and participant information.

#### Response Example
```json
[
  {
    "fixtureId": "id1000001764618978",
    "sportId": 10,
    "tournamentId": 17,
    "startTime": "2025-12-08T20:00:00.000Z",
    "statusId": 0,
    "participant1": {"name": "Team A"},
    "participant2": {"name": "Team B"}
  }
]
```
```

--------------------------------

### GET /v4/tournaments Endpoint

Source: https://oddspapi.io/us/docs/get-tournaments

Retrieves a list of leagues based on the specified sport and language. Requires a valid sportId.

```bash
**GET** /v4/tournaments?sportId=10&language=en
```

--------------------------------

### GET /v4/sports Endpoint

Source: https://oddspapi.io/us/docs/get-sports

This is the base endpoint for retrieving a list of sports. It can be used to fetch all available sports.

```bash
**GET** /v4/sports
```

--------------------------------

### GET /v4/markets

Source: https://oddspapi.io/us/docs/get-markets

Retrieves a list of all available markets in the system. You can filter the results by specifying a language.

```APIDOC
## GET /v4/markets

### Description
Retrieves a list of markets available in the system.

### Method
GET

### Endpoint
/v4/markets

### Parameters
#### Query Parameters
- **language** (a2) - Optional - The language in which the market information should be returned. By default, the value is `en` for English.

### Request Example
```
GET /v4/markets?language=en
```

### Response
#### Success Response (200 OK)
Returns a JSON array containing market objects. Each market object includes the following fields:
- **marketId** (number) - The unique identifier for the market.
- **marketLength** (number) - The number of outcomes in the market.
- **marketName** (string) - The name of the market.
- **playerProp** (boolean) - Indicates if the market is a player prop.
- **sportId** (number) - The identifier for the associated sport.
- **handicap** (number) - The handicap value for the market.
- **period** (string) - The period of play that the market relates to.
- **marketType** (string) - The type of the market.
- **outcomes** (array) - An array of outcome objects associated with the market, where each outcome includes:
  - **outcomeId** (number) - The unique identifier for the outcome.
  - **outcomeName** (string) - The name of the outcome.

#### Response Example
```json
[
  {
    "marketId": 101,
    "marketLength": 3,
    "marketName": "Full Time Result",
    "playerProp": false,
    "sportId": 10,
    "handicap": 0,
    "period": "fulltime",
    "marketType": "1x2",
    "outcomes": [
      {
        "outcomeId": 101,
        "outcomeName": "1"
      },
      {
        "outcomeId": 102,
        "outcomeName": "X"
      },
      {
        "outcomeId": 103,
        "outcomeName": "2"
      }
    ]
  }
]
```
```

--------------------------------

### Fixture and Odds Data Example

Source: https://oddspapi.io/us/docs

Sample JSON response containing fixture details and odds from a bookmaker. Includes market information and prices for outcomes.

```json
[
  {
    "fixtureId": "id1000001764618978",
    "participant1Id": 3,
    "participant2Id": 35,
    "sportId": 10,
    "tournamentId": 17,
    "seasonId": 130281,
    "statusId": 0,
    "hasOdds": true,
    "startTime": "2025-12-08T20:00:00.000Z",
    "trueStartTime": null,
    "trueEndTime": null,
    "updatedAt": "2025-12-02T08:01:48.812Z",
    "bookmakerOdds": {
      "pinnacle": {
        "bookmakerIsActive": true,
        "bookmakerFixtureId": "1620599468",
        "fixturePath": "https://www.pinnacle.com/en/e/e/e/1620599468/#all",
        "markets": {
          "101": {
            "outcomes": {
              "101": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "home",
                    "changedAt": "2025-12-07T22:50:48.515996+00:00",
                    "limit": 5000,
                    "playerName": null,
                    "price": 5.01,
                    "exchangeMeta": {}
                  }
                }
              },
              "102": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "draw",
                    "changedAt": "2025-12-07T22:50:48.516257+00:00",
                    "limit": 5000,
                    "playerName": null,
                    "price": 4.32,
                    "exchangeMeta": {}
                  }
                }
              },
              "103": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "away",
                    "changedAt": "2025-12-07T22:50:48.516384+00:00",
                    "limit": 7704,
                    "playerName": null,
                    "price": 1.649,
                    "exchangeMeta": {}
                  }
                }
              }
            },
            "bookmakerMarketId": "line/29/1980/1620128138/3377661430/0/moneyline"
          },
          "104": {
            "outcomes": {
              "104": {
                "players": {
                  "0": {
                    "active": true,
                    "betslip": null,
                    "bookmakerOutcomeId": "1620599418",
                    "changedAt": "2025-12-07T21:33:08.962871+00:00",
                    "limit": 705,
                    "playerName": null,
                    "price": 1.709,
                    "exchangeMeta": {}

```

--------------------------------

### Example Market Response

Source: https://oddspapi.io/us/docs/get-markets

A successful response contains a JSON array of market objects, each detailing market properties like ID, name, type, and associated outcomes.

```json
[
  {
    "marketId": 101,
    "marketLength": 3,
    "marketName": "Full Time Result",
    "playerProp": false,
    "sportId": 10,
    "handicap": 0,
    "period": "fulltime",
    "marketType": "1x2",
    "outcomes": [
      {
        "outcomeId": 101,
        "outcomeName": "1"
      },
      {
        "outcomeId": 102,
        "outcomeName": "X"
      },
      {
        "outcomeId": 103,
        "outcomeName": "2"
      }
    ]
  },
  {
    "marketId": 104,
    "marketLength": 2,
    "marketName": "Both Teams To Score",
    "playerProp": false,
    "sportId": 10,
    "handicap": 0,
    "period": "fulltime",
    "marketType": "totals",
    "outcomes": [
      {
        "outcomeId": 104,
        "outcomeName": "Yes"
      },
      {
        "outcomeId": 105,
        "outcomeName": "No"
      }
    ]
  },
  {
    "marketId": 106,
    "marketLength": 2,
    "marketName": "Over Under Full Time",
    "playerProp": false,
    "sportId": 10,
    "handicap": 0.5,
    "period": "fulltime",
    "marketType": "totals",
    "outcomes": [
      {
        "outcomeId": 106,
        "outcomeName": "Over"
      },
      {
        "outcomeId": 107,
        "outcomeName": "Under"
      }
    ]
  }
]
```

--------------------------------

### Sample Fixture Response

Source: https://oddspapi.io/us/docs/get-fixture

This is a sample JSON response for a fixture, including details like participant information, sport, tournament, status, and external provider mappings. Note that odds data is not included.

```json
{
  "fixtureId": "id1000001761301153",
  "participant1Id": 35,
  "participant2Id": 34,
  "sportId": 10,
  "tournamentId": 17,
  "seasonId": 130281,
  "statusId": 0,
  "hasOdds": true,
  "startTime": "2026-04-13T19:00:00.000Z",
  "trueStartTime": null,
  "trueEndTime": null,
  "updatedAt": "2026-04-06T23:17:08.202Z",
  "externalProviders": {
    "betradarId": 61301153,
    "mollybetId": "2026-04-13,35,34",
    "opticoddsId": "20260413A1B2C3D4",
    "lsportsId": null,
    "txoddsId": null,
    "sofascoreId": 15676100,
    "betgeniusId": 13670012,
    "flashscoreId": "xK4pLm2n",
    "pinnacleId": 1626291706,
    "oddinId": null
  },
  "statusName": "Pre-Game",
  "participant1Name": "Liverpool FC",
  "participant1ShortName": "Liverpool",
  "participant1Abbr": "LIV",
  "participant2Name": "Manchester United",
  "participant2ShortName": "Man Utd",
  "participant2Abbr": "MNU",
  "sportName": "Soccer",
  "tournamentSlug": "premier-league",
  "categorySlug": "england",
  "categoryName": "England",
  "tournamentName": "Premier League"
}
```

--------------------------------

### GET Account Endpoint

Source: https://oddspapi.io/us/docs/get-account

Use this endpoint to retrieve your account details, such as your API key, subscription status, and request limits. Ensure your API key is included for authentication.

```bash
GET /v4/account
```

--------------------------------

### Historical Odds Response Example

Source: https://oddspapi.io/us/docs/get-historical-odds

Example JSON response structure for historical odds, showing nested data for bookmakers, markets, outcomes, and player odds over time.

```json
{
  "fixtureId": "id1000000758265379",
  "bookmakers": {
    "pinnacle": {
      "markets": {
        "101": {
          "outcomes": {
            "101": {
              "players": {
                "0": [
                  {
                    "createdAt": "2025-04-16T21:12:10.506331+00:00",
                    "price": 9.11,
                    "limit": 1191.25,
                    "active": false,
                    "exchangeMeta": null
                  },
                  {
                    "createdAt": "2025-04-16T20:50:58.321847+00:00",
                    "price": 9.11,
                    "limit": 1191.25,
                    "active": true,
                    "exchangeMeta": null
                  }
                ]
              }
            }
          }
        },
        "10168": {
          "outcomes": {
            "10168": {
              "players": {
                "0": [
                  {
                    "createdAt": "2025-04-16T20:16:45.057806+00:00",
                    "price": 1.729,
                    "limit": 13072.7023319616,
                    "active": false,
                    "exchangeMeta": null
                  },
                  {
                    "createdAt": "2025-04-16T20:16:18.597131+00:00",
                    "price": 1.729,
                    "limit": 13072.7023319616,
                    "active": true,
                    "exchangeMeta": null
                  },
                  {
                    "createdAt": "2025-04-16T20:15:51.441377+00:00",
                    "price": 1.699,
                    "limit": 13633.7625178827,
                    "active": true,
                    "exchangeMeta": null
                  }
                ]
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Supported Languages

Source: https://oddspapi.io/us/docs/get-languages

Retrieves a list of supported languages available in the system. This endpoint does not require any request parameters and is useful for setting language preferences.

```bash
GET /v4/languages
```

--------------------------------

### Get Scores

Source: https://oddspapi.io/us/docs/methods/get-account

Retrieves final scores for completed fixtures.

```APIDOC
## GET /v4/scores

### Description
Fetches the final scores for completed fixtures.

### Method
GET

### Endpoint
/v4/scores

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your unique API key for authentication.
- **fixtureIds** (string) - Required - A comma-separated list of fixture IDs for which to retrieve scores.

### Response
#### Success Response (200)
- An array of objects, where each object corresponds to a fixture and contains its `fixtureId` and `score` details.

#### Response Example
```json
[
  {
    "fixtureId": "id1000001764618978",
    "score": {
      "participant1Score": "2",
      "participant2Score": "1",
      "fullTime": true
    }
  }
]
```
```

--------------------------------

### GET /fixture

Source: https://oddspapi.io/us/docs/get-fixture

Retrieves details for a specific sports fixture by its ID.

```APIDOC
## GET /fixture

### Description
Retrieves details for a specific sports fixture by its ID.

### Method
GET

### Endpoint
/fixture

### Parameters
#### Query Parameters
- **id** (string) - Required - The ID of the fixture to retrieve.
- **odds_format** (string) - Optional - Specify odds format (e.g., decimal, american).
- **include_probability** (boolean) - Optional - Include probability in the response.

### Response
#### Success Response (200)
- **fixture** (object) - Details of the requested fixture.
  - **id** (string) - Fixture ID.
  - **sport_id** (string) - Sport ID.
  - **league_id** (string) - League ID.
  - **bookmaker_id** (string) - Bookmaker ID.
  - **starts_at** (string) - Start time of the fixture.
  - **ends_at** (string) - End time of the fixture.
  - **name** (string) - Fixture name.
  - **user_count** (integer) - Number of users interested.
  - **probability_home_win** (number) - Probability of home team winning.
  - **probability_draw** (number) - Probability of a draw.
  - **probability_away_win** (number) - Probability of away team winning.
  - **odds_type** (string) - Type of odds.
  - **odds_format** (string) - Format of odds.
  - **home_team** (string) - Home team name.
  - **away_team** (string) - Away team name.
  - **home_team_id** (string) - Home team ID.
  - **away_team_id** (string) - Away team ID.
  - **league** (object) - League details.
    - **id** (string) - League ID.
    - **name** (string) - League name.
    - **sport_id** (string) - Sport ID.
    - **region_id** (string) - Region ID.
  - **bookmaker** (object) - Bookmaker details.
    - **id** (string) - Bookmaker ID.
    - **name** (string) - Bookmaker name.
    - **key** (string) - Bookmaker key.
    - **logo** (string) - Bookmaker logo URL.
    - **country** (string) - Bookmaker country.
    - **rank** (integer) - Bookmaker rank.

### Response Example
{
  "fixture": {
    "id": "12345",
    "sport_id": "1",
    "league_id": "10",
    "bookmaker_id": "50",
    "starts_at": "2023-10-27T18:00:00Z",
    "ends_at": "2023-10-27T20:00:00Z",
    "name": "Team A vs Team B",
    "user_count": 150,
    "probability_home_win": 0.55,
    "probability_draw": 0.25,
    "probability_away_win": 0.20,
    "odds_type": "3_way",
    "odds_format": "decimal",
    "home_team": "Team A",
    "away_team": "Team B",
    "home_team_id": "101",
    "away_team_id": "102",
    "league": {
      "id": "10",
      "name": "Premier League",
      "sport_id": "1",
      "region_id": "2"
    },
    "bookmaker": {
      "id": "50",
      "name": "Example Bookmaker",
      "key": "exbk",
      "logo": "http://example.com/logo.png",
      "country": "UK",
      "rank": 1
    }
  }
}
```

--------------------------------

### Example Response for Refresh API Key

Source: https://oddspapi.io/us/docs/post-refresh-api-key

A successful request to refresh an API key returns a JSON object containing the new API key.

```json
{
  "api_key": "67hbdfu-oijd83Hdf-92kfd72bhfd-gbdvgl18bhsd"
}
```

--------------------------------

### Get Languages

Source: https://oddspapi.io/us/docs/methods/get-account

Retrieves a list of supported languages for sports data.

```APIDOC
## GET /v4/languages

### Description
Fetches a list of all supported languages for sports data available through the API.

### Method
GET

### Endpoint
/v4/languages

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your unique API key for authentication.

### Response
#### Success Response (200)
- An array of language objects, each containing `languageId`, `languageName`, and `languageCode`.

#### Response Example
```json
[
  {
    "languageId": 1,
    "languageName": "English",
    "languageCode": "en"
  },
  {
    "languageId": 2,
    "languageName": "Spanish",
    "languageCode": "es"
  }
]
```
```

--------------------------------

### Get Sports

Source: https://oddspapi.io/us/docs/methods/get-account

Retrieves a list of all supported sports available in the API.

```APIDOC
## GET /v4/sports

### Description
Retrieves a comprehensive list of all sports covered by the OddsPapi API.

### Method
GET

### Endpoint
/v4/sports

### Parameters
#### Query Parameters
- **apiKey** (string) - Required - Your unique API key for authentication.

### Response
#### Success Response (200)
- An array of sport objects, each containing `sportId`, `sportName`, and `sportSlug`.

#### Response Example
```json
[
  {
    "sportId": 10,
    "sportName": "Football",
    "sportSlug": "football"
  },
  {
    "sportId": 12,
    "sportName": "Basketball",
    "sportSlug": "basketball"
  }
]
```
```
Tokens:
Raw