Markets
Markets related endpoints
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.
Number of markets to return.
25Example: 2Optional 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.
market:eq:total=1.5Possible values: The event id(s) to get markets for. Comma separated list in case of multiple event ids.
sr:match:23150637The user to get recommended markets for.
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.
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.
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.
The location of the page where the request takes place.
inplay_widgetCustom client header, the value should be the name of the group the user belongs to
Authentication method to be used, supported values [vaix, iam]. Defaults to vaix
OK
Bad Request
Unauthorized
Forbidden
Not Acceptable
Request Entity Too Large
Unprocessable Entity
Too Early
Internal Server Error
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"
}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.
Number of markets to return.
25Example: 2Optional 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.
market:eq:total=1.5Possible values: The event id(s) to get markets for. Comma separated list in case of multiple event ids.
sr:match:23150637The 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.
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.
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.
The location of the page where the request takes place.
inplay_widgetConsiders 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].
2dExample: 3hPattern: ^[+-]?[0-9]+([.][0-9]+)?[smhd]?$Custom client header, the value should be the name of the group the user belongs to
Authentication method to be used, supported values [vaix, iam]. Defaults to vaix
OK
Bad Request
Unauthorized
Forbidden
Not Acceptable
Request Entity Too Large
Unprocessable Entity
Too Early
Internal Server Error
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"
}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.
Number of markets to return.
25Example: 2Optional 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.
market:eq:total=1.5Possible values: The event id(s) to get markets for. Comma separated list in case of multiple event ids.
sr:match:23150637The 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.
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.
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.
The location of the page where the request takes place.
inplay_widgetCustom client header, the value should be the name of the group the user belongs to
Authentication method to be used, supported values [vaix, iam]. Defaults to vaix
OK
Bad Request
Unauthorized
Forbidden
Not Acceptable
Request Entity Too Large
Unprocessable Entity
Too Early
Internal Server Error
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"
}Was this helpful?