Market Descriptions

This endpoint defines all the available markets (covered by SR). It includes details such as outcomes, specifiers, and mapping outcomes for each market.

Market descriptions

get

Defines all currently available markets.

Authorizations

key

Path parameters

languagestringRequired

Language code for translation.

Query parameters

include_mappingsbooleanOptional

Choose whether market mappings should be included or not.

Responses

200

successful operation

application/xml

401

Unauthorized

application/json

403

Access denied

application/json

500

Internal server error

application/json

get

HTTPcURLJavaScriptPython

GET /v1/descriptions/{language}/markets.xml HTTP/1.1
Host: global.api.betradar.com
x-access-token: YOUR_API_KEY
Accept: */*

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<market_descriptions response_code="OK">
  <market id="282" name="Innings 1 to 5th top - {$competitor1} total" groups="all|score|4.5_innings">
    <outcomes>
      <outcome id="13" name="under {total}"/>
      <outcome id="12" name="over {total}"/>
    </outcomes>
    <specifiers>
      <specifier name="total" type="decimal"/>
    </specifiers>
    <mappings>
      <mapping product_id="1" product_ids="1|4" sport_id="sr:sport:3" market_id="8:232" sov_template="{total}">
        <mapping_outcome outcome_id="13" product_outcome_id="2528" product_outcome_name="under"/>
        <mapping_outcome outcome_id="12" product_outcome_id="2530" product_outcome_name="over"/>
      </mapping>
    </mappings>
  </market>
  <market id="361" name="1st over - odd/even" groups="all|score|over">
    <outcomes>
      <outcome id="70" name="odd"/>
      <outcome id="72" name="even"/>
    </outcomes>
    <mappings>
      <mapping product_id="3" product_ids="3" sport_id="sr:sport:21" market_id="342">
        <mapping_outcome outcome_id="70" product_outcome_id="9" product_outcome_name="Odd"/>
      </mapping>
    </mappings>
  </market>
</market_descriptions>

Endpoint Parameters

Parameter	Description	Possible Values
language Required	Language code for translation.	See all supported languages and their codes on language support
include_mapping Required	Choose whether market mappings should be included or not.	true, false true = inlude mapping information false = exclude mapping information

Endpoint Structure

With Mapping

• <market_descriptions>

  • <market>

    • <outcomes>

      • <outcome>

    • <specifiers>

      • <specifier>

    • <mappings>

      • <mapping>

        • <mapping_outcome>

Without Mapping

• <market_descriptions>

  • <market>

    • <outcomes>

      • <outcome>

    • <specifiers>

      • <specifier>

XML Example

Below, we present an example of the endpoint response with and without mapping. The information provided in the first example mirrors that of the second example, with the exception of the mapping element.

With Mapping

Request URL

https://api.betradar.com/v1/descriptions/en/markets.xml?include_mappings=true

Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <market_descriptions response_code="OK">
    <market id="282" name="Innings 1 to 5th top - {$competitor1} total" groups="all|score|4.5_innings">
      <outcomes>
        <outcome id="13" name="under {total}"/>
        <outcome id="12" name="over {total}"/>
      </outcomes>
      <specifiers>
        <specifier name="total" type="decimal"/>
      </specifiers>
      <mappings>
        <mapping product_id="1" product_ids="1|4" sport_id="sr:sport:3" market_id="8:232" sov_template="{total}">
          <mapping_outcome outcome_id="13" product_outcome_id="2528" product_outcome_name="under"/>
          <mapping_outcome outcome_id="12" product_outcome_id="2530" product_outcome_name="over"/>
        </mapping>
      </mappings>
    </market>
    ...
    <market id="361" name="1st over - odd/even" groups="all|score|over">
      <outcomes>
        <outcome id="70" name="odd"/>
        <outcome id="72" name="even"/>
      </outcomes>
      <mappings>
         <mapping product_id="3" product_ids="3" sport_id="sr:sport:21" market_id="342">
         <mapping_outcome outcome_id="70" product_outcome_id="9" product_outcome_name="Odd"/>
       </mapping>
    </market>
</market_descriptions>