Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Lucidchart
pageCount1
autoUpdatetrue
alignleft
typerich
autoSize1
macroIdecedf2ea-5045-4885-8763-b3190d04b3e6
instanceIdc1f2f8aa-fd3d-3053-9304-318e88b324bd
pages
width700
documentToken20151fe6-7ce9-44de-8e33-7bb5fe21674e|119919583|4275994729|M5pxzv0Xbx77wHfbdPL31TSPQQ1DyUNliCtxSQ2QNx4=
documentId20151fe6-7ce9-44de-8e33-7bb5fe21674e
updated1675423120274
height500

API Domain Names

Environment

Base URL

Notes

Swagger

Production

https://multibet.api.geniussports.com/v2/

Production environment

https://multibet.api.geniussports.com/api-docs/index.html#/

UAT

https://uat.multibet.api.geniussports.com/v2/

User Acceptance Testing. Limited capacity.

https://uat.multibet.api.geniussports.com/api-docs/index.html#/

Authentication

Please refer to the Multibet API Swagger for details regarding authenticating with the API https://multibet.api.geniussports.com/api-docs/index.html

...

  • Fixture Coverage - Returns sporting fixtures that are available to be used in Multibet

  • Market-types - Provides a list of markets and selections that are available to bet upon

  • Prices - The price of a particular multibet

  • Cashout - The cashout price of a particular multibet

  • Results - The result of a particular multibet

  • Markets - Valid only for customers who use Option 2. Multibet API + Sportsbook Integration. Calling this endpoint causes the Integration Service to create a market in the customer's Trading Platform and returns the market id from the Trading Platform along with any other available context.

    • Note: It is expected to receive a response status 404 Not found until the market is successfully created.

Info

For Market Types, Prices, Cashout, Results and Markets, please refer to the Multibet Swagger or the individual links above. For Fixture coverage, see below.

Fixture Coverage

Returns list of fixtures that are available to be used in Multibet. The Fixture Id is required to call the remaining three endpoints: Markets-types, Prices, Results

API Domain Names

Environment

Base URL

Notes

Production

https://public.coverage.api.geniussports.com

Production environment

UAT

https://uat.public.coverage.api.geniussports.com

User Acceptance Testing. Limited capacity.

Authentication

You should go through all steps in “Get Cognito Token and authenticate using the Coverage API <api-key>

...

GET sports/10/fixtures/123456/market-types?limitTo=MatchResult,HomeTeamTotalGoalsOverUnder

Code Block
languagejson
[
  {
    "id": "MatchResult",
    "name": "Match Result",
    "translatedName": "",
    "categoryName": "Match Result",
    "translatedCategoryName": "",
    "selections": {
      "MatchResult_Home": {
        "name": "Manchester United",
        "translatedName": "Man Utd",
        "compatible": true
        "probability": 0.123,
        "decimalPrice": 1.23,
        "suspended": false
      },
      "MatchResult_Draw": {
        "name": "Draw",
        "translatedName": "X",
        "compatible": true,
        "probability": 0.123,
        "decimalPrice": 1.23,
        "suspended": false
      },
      "MatchResult_Away": {
        "name": "Arsenal",
        "translatedName": "FC Arsenal",
        "compatible": true,
        "probability": 0.123,
        "decimalPrice": 1.23,
        "suspended": false
      }
    }
  },
  {
    "id": "HomeTeamTotalGoalsOverUnder",
    "name": "Manchester United Total Goals OverUnder",
    "translatedName": "Man Utd Total Goals Over/Under",
    "categoryName": "Home Team Total Goals OverUnder",
    "translatedCategoryName": "Home Team Total Goals Over/Under",
    "selections": {
      "HomeTeamTotalGoalsOverUnder_Over_0.5": {
        "name": "Over 0.5",
        "translatedName": "Over 0.5",
        "compatible": falsetrue
      },
   "probability": 0.123,
        "decimalPrice": 1.23,
        "suspended": false
      },
      "HomeTeamTotalGoalsOverUnder_Over_1.5": {
        "name": "Over 1.5",
        "compatible": true,
        "translatedName": "Over 1.5",
        "probability": 0.123,
        "decimalPrice": 1.23,
        "suspended": false
      },
      "HomeTeamTotalGoalsOverUnder_Over_2.5": {
        "name": "Over 2.5",
        "translatedName": "Over 2.5",
        "compatible": true,
        "probability": 0.123,
        "decimalPrice": 1.23,
        "suspended": false
      }
    }
  }
]

...

To get the price for the current bet: GET sports/10/fixtures/123456/prices?legs=MatchResult_Home

Code Block
languagejson
{
    "decimalPrice": 1.66,
    "probability": 0.5656463943226999,
    "suspended": false,
  }

The following request gets the list of available markets taking into account the already selected leg.

Note: The Match Result market will not be included in the response because it is already used in one of the legs. The probabilities and prices take into account that the Match Result Home leg is included in the bet.

GET sports/10/fixtures/123456/market-types?legs=MatchResult_Home

Code Block
[
  {
    "id": "HomeTeamTotalGoalsOverUnder",
    "name": "Manchester United Total Goals OverUnder",  "status": "available",
    "legs": [
        {
            "id": "MatchResult_Away",
            "status": "trading"
        }
    ]
}

Step 3: Get the list of the compatible market types to show to the user after one leg is selected

The following request gets the list of available markets taking into account the already selected leg:

GET sports/10/fixtures/123456/market-types?legs=MatchResult_Home&limitTo=MatchResult,HomeTeamTotalGoalsOverUnder

Info

The Match Result market will be included in the response as compatible:false because it is already used in one of the legs. The probabilities and prices take into account that the Match Result Home leg is included in the bet.

Code Block
languagejson
[
  {
    "id": "MatchResult",
    "name": "Match Result",
    "translatedName": "",
    "categoryName": "Match Result",
    "translatedCategoryName": "",
    "selections": {
      "MatchResult_Home": {
        "name": "Manchester United",
        "translatedName": "Man Utd",
        "compatible": false
        "suspended": false
      },
      "MatchResult_Draw": {
        "name": "Draw",
        "translatedName": "X",
        "compatible": false
        "suspended": false
      },
      "MatchResult_Away": {
        "name": "Arsenal",
        "translatedName": "FC Arsenal",
        "compatible": false,
        "suspended": false
      }
    }
  },
  {
    "id": "HomeTeamTotalGoalsOverUnder",
    "name": "Manchester United Total Goals OverUnder",
    "translatedName": "Man Utd Total Goals Over/Under",
    "categoryName": "Home Team Total Goals OverUnder",
    "translatedCategoryName": "Home Team Total Goals Over/Under",
    "selections": {
      "HomeTeamTotalGoalsOverUnder_Over_0.5": {
        "name": "Over 0.5",
        "translatedName": "Over 0.5",
        "compatible": true
        "probability": 0.123,
        "decimalPrice": 1.23,
        "suspended": false
      },
      "HomeTeamTotalGoalsOverUnder_Over_1.5": {
        "name": "Over 1.5",
        "compatible": true,
        "translatedName": "

...

Over 1.5",
        "probability": 0.123,
        "

...

decimalPrice": 

...

1.23,
        "

...

suspended": 

...

false

...

 

...

 

...

 

...

   

...

},
      

...

"HomeTeamTotalGoalsOverUnder_Over_

...

2.5": {
        "name": "Over 

...

2.5",
        "translatedName": "Over 

...

2.5",
        "compatible": true,
  

...

      

...

"probability": 0.123,
      

...

  "decimalPrice": 

...

1.23,
        

...

"suspended": false
      }

...

 

...

   }
  }

...

]

Step 3: User adds a second leg (HomeTeamTotalGoalsOverUnder_Over_2.5) to the bet

The following call gets the price for the current bet: GET sports/10/fixtures/123456/prices?legs=MatchResult_Home,HomeTeamTotalGoalsOverUnder_Over_2.5

Code Block
languagejson
{
        "decimalPrice": 1.23,
        "suspended": false
      },
 77,
    "HomeTeamTotalGoalsOverUnder_Over_2.5probability": {0.4656463943226999,
    "suspended": false,
    "namestatus": "Over 2.5available",
   
    "translatedNamelegs": "Over 2.5",[
        {
  "compatible": true,         "probabilityid": 0.123,"MatchResult_Home",
            "decimalPricestatus": 1.23,"trading"
        },
  "suspended": false     {
 }     }   } ]

Step 3: User adds a second leg (HomeTeamTotalGoalsOverUnder_Over_2.5) to the bet

...

  "id": "HomeTeamTotalGoalsOverUnder_Over_2.5

...

Code Block
{",
            "decimalPricestatus": 1.77, "trading"
      "probability": 0.4656463943226999, }
   "suspended": false]
}

Step 4: Request to create a market for the required bet

...

GET /sports/10/fixtures/123456/markets?legs=legs=MatchResult_Home%2CHomeTeamTotalGoalsOverUnderHome,HomeTeamTotalGoalsOverUnder_Over_2.5

Code Block
languagejson
{
  "id": "104517634",
  "tradingPlatformId": "123abc",
  "tradingPlatformMetadata": "CP$null$6768414.2$Lions%20v%20Jaguares$45592268.2...",
  "tradingPlatformFixtureId": "1234"
}

...

GET sports/10/fixtures/123456/results?legs=MatchResult_Home,HomeTeamTotalGoalsOverUnder_Over_2.5

Code Block
languagejson
{
    "result": "lose",
    "legResults": [
        {
            "leg": "MatchResult_Home",
            "legResult": "win"
        },
        {
            "leg": "HomeTeamTotalGoalsOverUnder_Over_2.5",
            "legResult": "lose"
        }
    ]
}

...