Tickets

Sport tickets related endpoints

Get recommended handpicked tickets

get

https://api.vaix.aihttps://staging-api.vaix.ai

/api/handpicked/recommended

Returns recommended handpicked tickets.

!!!info Ticket generation Each ticket consists of a set of selections.

The tickets are chosen from handpicked coupons stored in our database. Currently, those are Kambi prepacked coupons.

The recommendations are generated using a machine learning model. The recommendations are personalized for each user based on their betting history and preferences.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

fromstring · date-timeOptional

The minimum event's starting datetime.

from_offsetstringOptional

Considers events starting after the from timestamp plus the given minutes/hours/days. If not set defaults to 0 minutes. The value must be in range [-7d - 7d].

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

to_offsetstringOptional

Considers events starting till the from timestamp plus the given minutes/hours/days. If not set defaults to one day (24 hours). The value must be in range [-7d - 7d].

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

userstringRequired

The user ID for whom to generate recommendations.

countinteger · min: 1 · max: 100Optional

How many tickets to return.

Default: 10Example: 10

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.

filtersstring · enumOptional

A list of filters to filter the coupons or the events that will be considered when selecting the coupons. If not provided no filtering is applied.

Possible values:

group_limitstring · enumOptional

Applies a limit to a group of items. For more information, head to Limiting -> Group Limiting section of the docs. country:5,country_id:2.

Possible values:

use_precomputed_embeddingsbooleanOptional

If true, use precomputed embeddings for similarity search instead of the full model pipeline.

Default: false

locationstringOptional

The location of the page where the request takes place.

Example: inplay_widget

fieldsstring · enumOptional

Optional selection of the object fields to retrieve. It expects a comma separated list of strings, as described in the field selection section, e.g. coupon_id,sub_tenant_id.

Default: ["coupon_id","sub_tenant_id","event_id","selections","league_id","confidence","coupon_status","coupon_type","coupon_odds","coupon_source","coupon_tags","country_id","country","league","sport","sport_id","participants","participant_ids","event_type","status"]Possible values:

populationinteger · min: 500 · max: 10000Optional

The number of the retrieved top similar results. This can be useful in cases where the system needs to request more results than requested by the user, for example when applying a group limit to satisfy the required number of results in each group. Big population value may degrade performance.

Default: 1000

order_bystring · enumOptional

The columns to sort the results by. It expects a string adhering to the ordering format, as described in the ordering section, e.g. +begin.

Possible values:

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

OK

application/json

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/handpicked/recommended

HTTPcURLJavaScriptPython

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

{
  "data": {
    "id": "text",
    "odds": 1,
    "selections": [
      {
        "event_id": "text",
        "market": "text",
        "market_id": "text",
        "market_type": "text",
        "market_type_id": "text",
        "outcome": "text",
        "outcome_id": "text",
        "period": "text",
        "period_id": "text",
        "quote": 1,
        "quote_group": 1,
        "selection_id": "text",
        "status": "text"
      }
    ],
    "source": "text",
    "status": "text",
    "tags": [
      "text"
    ],
    "type": "text"
  }
}