Markets

Markets related endpoints

Get recommended markets

get

/api/sports/markets/recommended

Returns personalized market recommendations.

Retrieves the available markets for the given event ids and ranks them based on the given user's preferences.

Invalid or new user

If the given user is invalid or has no betting history then the popular markets for the given events will be returned.

Multiple event ids

You can specify multiple event ids to get recommended markets in a single request.

If an id is invalid or no markets are found then an empty list will be returned as its markets.

Confidence

Each returned item is associated with a number from 0 to 1 indicating the confidence of the system in this specific recommendation. The higher the number the more confident the recommendation of it.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

countinteger · min: 1Optional

Number of markets to return.

Default: 25Example: 2

filtersstring · enumOptional

Optional filtering of the markets to retrieve. It expects a string adhering to the filtering format, as described in the filtering section, e.g. market_type:eq:1X2.

Example: market:eq:total=1.5Possible values:

event_idsstringRequired

The event id(s) to get markets for. Comma separated list in case of multiple event ids.

Example: sr:match:23150637

userstringRequired

The user to get recommended markets for.

operatorstringOptional

The operator to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored.

bookmaker_idintegerOptional

The bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the sub_bookmaker_id parameter.

sub_bookmaker_idintegerOptional

The sub-bookmaker id to use for querying data. Notice that this is applied only if your account has access to multiple operators. In a different case the assigned operator to your account is used and the value of this field is ignored. Note that this parameter is used together with the bookmaker_id parameter.

locationstringOptional

The location of the page where the request takes place.

Example: inplay_widget

Header parameters

x-vaix-client-idstringRequired

Custom client header, the value should be the name of the group the user belongs to

x-vaix-authentication-methodstringOptional

Authentication method to be used, supported values [vaix, iam]. Defaults to vaix

Responses

200

application/json

API response

statusstring · enumOptional

The status of the request

Possible values:

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

406

Not Acceptable

application/json

413

Request Entity Too Large

application/json

422

Unprocessable Entity

application/json

425

Too Early

application/json

500

Internal Server Error

application/json

get

/api/sports/markets/recommended

GET /api/sports/markets/recommended?event_ids=text&user=text HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*

{
  "data": [
    {
      "event_id": "sr:match:21514503",
      "markets": [
        {
          "children": [
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 289,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 3,
                  "period": null,
                  "period_id": null,
                  "quote": 1.2,
                  "quote_group": "1.2-1.4",
                  "selection_id": "53dc2a7096d543c0788512271bcb6470",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/3"
                }
              ],
              "confidence": 0.006573163981810748,
              "id": null,
              "name": "3/1.2-1.4",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 27,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 2,
                  "period": null,
                  "period_id": null,
                  "quote": 5.8,
                  "quote_group": "4.2-7.4",
                  "selection_id": "dff6f42ca6794201515a81321b26c085",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/2"
                }
              ],
              "confidence": 0.0009166977176614438,
              "id": null,
              "name": "2/4.2-7.4",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 28,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 1,
                  "period": null,
                  "period_id": null,
                  "quote": 8.5,
                  "quote_group": "7.4-13.8",
                  "selection_id": "ffcee7dee4e80c3115f06336d10e0e41",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/1"
                }
              ],
              "confidence": 0.00036682379072955964,
              "id": null,
              "name": "1/7.4-13.8",
              "type": "outcome_id_quote_group"
            }
          ],
          "confidence": 0.12048529386125492,
          "id": null,
          "name": 1,
          "type": "market_type_id"
        },
        {
          "children": [
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 5,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 10,
                  "outcome": null,
                  "outcome_id": 9,
                  "period": null,
                  "period_id": null,
                  "quote": 1.25,
                  "quote_group": "1.2-1.4",
                  "selection_id": "a7b3fc6e0579f15998c22062992d9af2",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/10/9"
                }
              ],
              "confidence": 0.032270916334661344,
              "id": null,
              "name": "9/1.2-1.4",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 1,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 10,
                  "outcome": null,
                  "outcome_id": 11,
                  "period": null,
                  "period_id": null,
                  "quote": 1.1399,
                  "quote_group": "1.1-1.2",
                  "selection_id": "1a44f6984cc0932b9f1e320427eaf689",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/10/11"
                }
              ],
              "confidence": 0.011026370707645606,
              "id": null,
              "name": "11/1.1-1.2",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 1,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 10,
                  "outcome": null,
                  "outcome_id": 10,
                  "period": null,
                  "period_id": null,
                  "quote": 8.5,
                  "quote_group": "7.4-13.8",
                  "selection_id": "f56e051a4f27a36cc26cefbaf9ccb6f8",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/10/10"
                }
              ],
              "confidence": 0,
              "id": null,
              "name": "10/7.4-13.8",
              "type": "outcome_id_quote_group"
            }
          ],
          "confidence": 0.022974527956483075,
          "id": null,
          "name": 10,
          "type": "market_type_id"
        }
      ]
    }
  ],
  "status": "success"
}

get

/api/sports/markets/trending

Returns trending markets for the given event ids.

Retrieves the trending markets for the given event.

Multiple event ids

You can specify multiple event ids to get trending markets in a single request.

If an id is invalid or no markets are found then an empty list will be returned as its markets.

Confidence

Each returned item is associated with a number from 0 to 1 indicating the confidence of the system in this specific trending. The higher the number the more trending the item.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

countinteger · min: 1Optional

Number of markets to return.

Default: 25Example: 2

filtersstring · enumOptional

Optional filtering of the markets to retrieve. It expects a string adhering to the filtering format, as described in the filtering section, e.g. market_type:eq:1X2.

Example: market:eq:total=1.5Possible values:

event_idsstringRequired

The event id(s) to get markets for. Comma separated list in case of multiple event ids.

Example: sr:match:23150637

operatorstringOptional

bookmaker_idintegerOptional

sub_bookmaker_idintegerOptional

locationstringOptional

The location of the page where the request takes place.

Example: inplay_widget

trending_withinstringOptional

Considers bets placed after the current timestamp minus the given minutes/hours/days. If not set defaults to 2 days. The value must be in range [1m - 7d].

Default: 2dExample: 3hPattern: ^[+-]?[0-9]+([.][0-9]+)?[smhd]?$

Header parameters

x-vaix-client-idstringRequired

Custom client header, the value should be the name of the group the user belongs to

x-vaix-authentication-methodstringOptional

Authentication method to be used, supported values [vaix, iam]. Defaults to vaix

Responses

200

application/json

API response

statusstring · enumOptional

The status of the request

Possible values:

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

406

Not Acceptable

application/json

413

Request Entity Too Large

application/json

422

Unprocessable Entity

application/json

425

Too Early

application/json

500

Internal Server Error

application/json

get

/api/sports/markets/trending

GET /api/sports/markets/trending?event_ids=text HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*

{
  "data": [
    {
      "event_id": "sr:match:21514503",
      "markets": [
        {
          "children": [
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 3,
                  "period": null,
                  "period_id": null,
                  "quote": 1.2,
                  "quote_group": "1.2-1.4",
                  "score": 182.5516967572033,
                  "selection_id": "53dc2a7096d543c0788512271bcb6470",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/3"
                }
              ],
              "confidence": 0.831560179828873,
              "id": null,
              "name": "3/1.2-1.4",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 1,
                  "period": null,
                  "period_id": null,
                  "quote": 8.5,
                  "quote_group": "7.4-13.8",
                  "score": 19.55416003681111,
                  "selection_id": "ffcee7dee4e80c3115f06336d10e0e41",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/1"
                }
              ],
              "confidence": 0.08907318379099967,
              "id": null,
              "name": "1/7.4-13.8",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 2,
                  "period": null,
                  "period_id": null,
                  "quote": 5.8,
                  "quote_group": "4.2-7.4",
                  "score": 17.423289965719388,
                  "selection_id": "dff6f42ca6794201515a81321b26c085",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/2"
                }
              ],
              "confidence": 0.07936663638012727,
              "id": null,
              "name": "2/4.2-7.4",
              "type": "outcome_id_quote_group"
            }
          ],
          "confidence": 0.5698371991872477,
          "id": null,
          "name": 1,
          "type": "market_type_id"
        }
      ]
    },
    {
      "event_id": "sr:match:21516115",
      "markets": [
        {
          "children": [
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "market": "total=3.5",
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 18,
                  "outcome": null,
                  "outcome_id": 12,
                  "period": null,
                  "period_id": null,
                  "quote": 1.7,
                  "quote_group": "1.4-1.8",
                  "score": 0,
                  "selection_id": "11cc7df517723a4d82399db8e30e274d",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/18/12?total=3.5"
                }
              ],
              "confidence": 0,
              "id": null,
              "name": "12/1.4-1.8",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "market": "total=2.5",
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 18,
                  "outcome": null,
                  "outcome_id": 12,
                  "period": null,
                  "period_id": null,
                  "quote": 2.5,
                  "quote_group": "1.8-2.6",
                  "score": 0,
                  "selection_id": "9d7589ead6b3b15186c43d8749eeddb3",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/18/12?total=2.5"
                }
              ],
              "confidence": 0,
              "id": null,
              "name": "12/1.8-2.6",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "market": "total=4.5",
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 18,
                  "outcome": null,
                  "outcome_id": 13,
                  "period": null,
                  "period_id": null,
                  "quote": 1.7,
                  "quote_group": "1.4-1.8",
                  "score": 0,
                  "selection_id": "cc3bfb0d0c3bc222c197e297ee29905c",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/18/13?total=4.5"
                }
              ],
              "confidence": 0,
              "id": null,
              "name": "13/1.4-1.8",
              "type": "outcome_id_quote_group"
            }
          ],
          "confidence": 0,
          "id": null,
          "name": 18,
          "type": "market_type_id"
        }
      ]
    },
    {
      "event_id": "invalid_id",
      "markets": []
    }
  ],
  "status": "success"
}

Get popular markets

get

/api/sports/markets/popular

Returns popular markets.

Retrieves the popular markets for the given event ids.

Multiple event ids

You can specify multiple event ids to get popular markets in a single request.

If an id is invalid or no markets are found then an empty list will be returned as its markets.

Confidence

Each returned item is associated with a number from 0 to 1 indicating the confidence of the system in this specific popularity. The higher the number the more popular the item.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

countinteger · min: 1Optional

Number of markets to return.

Default: 25Example: 2

filtersstring · enumOptional

Optional filtering of the markets to retrieve. It expects a string adhering to the filtering format, as described in the filtering section, e.g. market_type:eq:1X2.

Example: market:eq:total=1.5Possible values:

event_idsstringRequired

The event id(s) to get markets for. Comma separated list in case of multiple event ids.

Example: sr:match:23150637

operatorstringOptional

bookmaker_idintegerOptional

sub_bookmaker_idintegerOptional

locationstringOptional

The location of the page where the request takes place.

Example: inplay_widget

Header parameters

x-vaix-client-idstringRequired

Custom client header, the value should be the name of the group the user belongs to

x-vaix-authentication-methodstringOptional

Authentication method to be used, supported values [vaix, iam]. Defaults to vaix

Responses

200

application/json

API response

statusstring · enumOptional

The status of the request

Possible values:

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

406

Not Acceptable

application/json

413

Request Entity Too Large

application/json

422

Unprocessable Entity

application/json

425

Too Early

application/json

500

Internal Server Error

application/json

get

/api/sports/markets/popular

GET /api/sports/markets/popular?event_ids=text HTTP/1.1
Host: api.vaix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
x-vaix-client-id: text
Accept: */*

{
  "data": [
    {
      "event_id": "sr:match:21514503",
      "markets": [
        {
          "children": [
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 289,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 3,
                  "period": null,
                  "period_id": null,
                  "quote": 1.2,
                  "quote_group": "1.2-1.4",
                  "selection_id": "53dc2a7096d543c0788512271bcb6470",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/3"
                }
              ],
              "confidence": 0.8401162790697675,
              "id": null,
              "name": "3/1.2-1.4",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 28,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 1,
                  "period": null,
                  "period_id": null,
                  "quote": 8.5,
                  "quote_group": "7.4-13.8",
                  "selection_id": "ffcee7dee4e80c3115f06336d10e0e41",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/1"
                }
              ],
              "confidence": 0.08139534883720931,
              "id": null,
              "name": "1/7.4-13.8",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 27,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 2,
                  "period": null,
                  "period_id": null,
                  "quote": 5.8,
                  "quote_group": "4.2-7.4",
                  "selection_id": "dff6f42ca6794201515a81321b26c085",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/2"
                }
              ],
              "confidence": 0.07848837209302326,
              "id": null,
              "name": "2/4.2-7.4",
              "type": "outcome_id_quote_group"
            }
          ],
          "confidence": 0.588034188034188,
          "id": null,
          "name": 1,
          "type": "market_type_id"
        }
      ]
    },
    {
      "event_id": "sr:match:21516115",
      "markets": [
        {
          "children": [
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 145,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 3,
                  "period": null,
                  "period_id": null,
                  "quote": 1.25,
                  "quote_group": "1.2-1.4",
                  "selection_id": "dc7731470a435c839eccf7e28b6c5630",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/3"
                }
              ],
              "confidence": 0.4588607594936709,
              "id": null,
              "name": "3/1.2-1.4",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 97,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 1,
                  "period": null,
                  "period_id": null,
                  "quote": 3.55,
                  "quote_group": "2.6-4.2",
                  "selection_id": "6e5ca16e34855702209f267dd513d7c5",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/1"
                }
              ],
              "confidence": 0.3069620253164557,
              "id": null,
              "name": "1/2.6-4.2",
              "type": "outcome_id_quote_group"
            },
            {
              "children": [
                {
                  "bet_offer_id": null,
                  "count": 74,
                  "market": null,
                  "market_id": null,
                  "market_type": null,
                  "market_type_id": 1,
                  "outcome": null,
                  "outcome_id": 2,
                  "period": null,
                  "period_id": null,
                  "quote": 4.9,
                  "quote_group": "4.2-7.4",
                  "selection_id": "ea2a59aaee5f84dbcb0c6e71b1688051",
                  "side": "back",
                  "uof_external_id": "uof:1/sr:sport:1/1/2"
                }
              ],
              "confidence": 0.23417721518987342,
              "id": null,
              "name": "2/4.2-7.4",
              "type": "outcome_id_quote_group"
            }
          ],
          "confidence": 0.4328767123287671,
          "id": null,
          "name": 1,
          "type": "market_type_id"
        }
      ]
    },
    {
      "event_id": "invalid_id",
      "markets": []
    }
  ],
  "status": "success"
}

PreviousSelections NextLeagues

Last updated 4 months ago

Was this helpful?

Good morning

hashtagGet recommended markets

hashtagInvalid or new user

hashtagMultiple event ids

hashtagConfidence

hashtagGet trending markets

hashtagMultiple event ids

hashtagConfidence

hashtagGet popular markets

hashtagMultiple event ids

hashtagConfidence

Get recommended markets

Invalid or new user

Multiple event ids

Confidence

Get trending markets

Multiple event ids

Confidence

Get popular markets

Multiple event ids

Confidence