...
Fixtures - Returns fixtures that are available to be used in Multibet
Markets-types - Provides a list of markets and selections that are available to bet upon
Prices - The price of a particular multibet
Results - The result of a particular multibet
Fixtures
Returns list of fixtures that are available to be used in Multibet. FixtureId is required to call the remaining three endpoints: Markets-types, Prices, Results
API Domain Names
Environment | Base URL | Notes |
---|---|---|
Production |
| Production environment |
UAT |
| User Acceptance Testing. Limited capacity. |
Authentication
You should go through all steps in “Getting an access token” section and authenticate using the Coverage API <api-key>
Getting an API key
Your <api-key>
for using Coverage API will be provided to you during the onboarding process.
Calling the API
Once you have an <access-token>
and your <api-key>
you can pass these as headers to the API:
Code Block |
---|
curl --request GET \ --url https://coverage.api.geniussports.com/api/MultibetPreMatchCoverage/event/{fixtureId} \ --header 'Authorization: Bearer <access-token> \' --header 'x-api-key: <api-key>' |
Fixtures Resources
Multibet Pre-Match coverage by sport and date range
Returns data about a particular fixture that will show this fixture is available for use in Multibet Pre-Match.
Path
GET MultibetPreMatchCoverage/range/sport/{sportId}/from/{from}/to/{to}
...
Example: https://coverage.api.geniussports.com/api/MultibetPreMatchCoverage/range/sport/10/from/2023-07-13/to/2023-07-15
Response Body
Code Block | ||
---|---|---|
| ||
[ { "betgeniusFixtureId": 123456, "sourceFixtureId": "123456", "source": "GeniusSportsMultibetPreMatch", "sportId": 10, "available": true, "coverageType": 4 }, { "betgeniusFixtureId": 1234567, "sourceFixtureId": "1234567", "source": "GeniusSportsMultibetPreMatch", "sportId": 10, "available": false, "coverageType": 4 }, { "betgeniusFixtureId": 12345678, "sourceFixtureId": "12345678", "source": "GeniusSportsMultibetPreMatch", "sportId": 10, "available": true, "coverageType": 4 } ] |
Multibet Pre-Match coverage by fixture
Returns data about a particular fixture that will show this fixture is available for use in Multibet Pre-Match.
Path
GET MultibetPreMatchCoverage/event/{fixtureId}
...
Example: https://coverage.api.geniussports.com/api/MultibetPreMatchCoverage/event/123456
Response Body
Code Block | ||
---|---|---|
| ||
[ { "betgeniusFixtureId": 123456, "sourceFixtureId": "123456", "source": "GeniusSportsMultibetPreMatch", "sportId": 10, "available": true, "coverageType": 4 } ] |
Multibet In-Play coverage by sport and date range
Returns data about a particular fixture that will show this fixture is available for use in Multibet In-Play.
Path
GET MultibetInPlayCoverage/range/sport/{sportId}/from/{from}/to/{to}
...
Example: https://coverage.api.geniussports.com/api/MultibetInPlayCoverage/range/sport/10/from/2023-07-13/to/2023-07-15
Response Body
Code Block | ||
---|---|---|
| ||
[ { "betgeniusFixtureId": 123456, "sourceFixtureId": "123456", "source": "GeniusSportsMultibetInPlay", "sportId": 10, "available": true, "coverageType": 4 }, { "betgeniusFixtureId": 1234567, "sourceFixtureId": "1234567", "source": "GeniusSportsMultibetInPlay", "sportId": 10, "available": false, "coverageType": 4 }, { "betgeniusFixtureId": 12345678, "sourceFixtureId": "12345678", "source": "GeniusSportsMultibetInPlay", "sportId": 10, "available": true, "coverageType": 4 } ] |
Multibet In-Play coverage by fixture
Returns data about a particular fixture that will show this fixture is available for use in Multibet In-Play.
Path
GET MultibetInPlayCoverage/event/{fixtureId}
...
Example: https://coverage.api.geniussports.com/api/MultibetInPlayCoverage/event/123456
Response Body
Code Block | ||
---|---|---|
| ||
[ { "betgeniusFixtureId": 123456, "sourceFixtureId": "123456", "source": "GeniusSportsMultibetInPlay", "sportId": 10, "available": true, "coverageType": 3 } ] |
...
Returns a list of available markets to bet upon for a particular fixture. The available markets is sport specific and will also be affected by the current state of the fixture and what bets are already included in the multibet. For instance it wouldn’t be possible to bet upon a first quarter market during the second quarter of a fixture.
Path
GET sports/{sportId}/fixtures/{fixtureId}/market-types?legs={legs}
...
Parameter | Encoding | Required | Description |
---|---|---|---|
legs | Leg Ids separated by “,” See: https://geniussports.atlassian.net/wiki/spaces/BID/pages/4284252757/Multibet+API#Leg-Id | No | The ids of any bets that are already included in the multibet. By providing this information the If this parameter is omitted then all available markets will be returned. |
Response Body
Field | Type | Nullable | Description |
---|---|---|---|
markets | Market[] See: https://geniussports.atlassian.net/wiki/spaces/BID/pages/4284252757/Multibet+API#Market | No | Array of markets available to bet upon |
...
Returns the price of the selected multibet.
Path
GET sports/{sportId}/fixtures/{fixtureId}/prices
...
Parameter | Encoding | Required | Description |
---|---|---|---|
legs | Leg Ids separated by “,” See: https://geniussports.atlassian.net/wiki/spaces/BID/pages/4284252757/Multibet+API#Leg-Id | Yes | The ids of the bet legs that are included in the multibet. The array must contain a minimum of one leg, maximum 50 legs and the legs must be unique. |
Response Body
Field | Type | Nullable | Description |
---|---|---|---|
decimalPrice | decimal | No | Decimal price for the multibet. Calculated from the probability of the bet winning with a margin applied. |
probability | decimal | No | Probability of the multibet winning. |
suspended | bool | No | Indicates that betting is currently suspended on one or more of the legs within the bet and it shouldn’t be accepted. Suspensions are generally short-term and relate to a temporary match situation such as a high risk of a score happening that could significantly affect probabilities. |
Code Block | ||
---|---|---|
| ||
{ "decimalPrice": 1.66, "probability": 0.5656463943226999, "suspended": false } |
Results
Path
GET sports/{sportId}/fixtures/{fixtureId}/results
...
Parameter | Encoding | Required | Description |
---|---|---|---|
legs | Leg Ids separated by “,” See: https://geniussports.atlassian.net/wiki/spaces/BID/pages/4284252757/Multibet+API#Leg-Id | Yes | The ids of the bet legs that are included in the multibet. The array must contain a minimum of one leg, maximum 50 legs and the legs must be unique. |
Response Body
Field | Type | Nullable | Description |
---|---|---|---|
result | x-extensible-enum See https://geniussports.atlassian.net/wiki/spaces/BID/pages/4284252757/Multibet+API#Result | No | Overall result of the multibet. |
legResults | LegResult[] See https://geniussports.atlassian.net/wiki/spaces/BID/pages/4284252757/Multibet+API#LegResult | No | Result of each individual leg within the multibet. Minimum length one, maximum length 50, unique entries. |
...