API BetTune

BetTune API

Интерактивная документация внешнего API BetTune: поиск матчей, получение prediction-фильтров и управление коэффициентами прогнозов.

Скачать OpenAPI схему

Базовый URL публичного API

https://ovaccess.com/bet-tune-api/v1

API token

Создать или перегенерировать API token можно на странице Settings в BetTune.

Открыть Settings BetTune

Только для PRO подписки

API BetTune доступен только пользователям с активной PRO подпиской.

Аутентификация

Authorization: Bearer ваш_bettune_api_token

Endpoint-ы

Откройте endpoint, чтобы посмотреть параметры, тело запроса, ответы, примеры и схемы.

get/sports

List available sports

Sports

Ответы

200 Available sports.

object

countобязательно

integer

itemsобязательно

array<object>

object

idобязательно

integer

пример: 1

nameобязательно

string

пример: "football"

{
  "count": 1,
  "items": [
    {
      "id": 1,
      "name": "football"
    }
  ]
}

401 Missing or invalid API token.

object

codeобязательно

string

messageобязательно

string

{
  "code": "missing_token",
  "message": "No token provided"
}

429 Rate limit exceeded.

object

codeобязательно

string

messageобязательно

string

{
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded"
}

Заголовки: Retry-After, X-RateLimit-Limit, X-RateLimit-Window

get/matches

List matches for one UTC date

Matches

Параметры

Название	Где	Обязательный	Тип	Описание
date	query	Да	string:date	UTC date in `YYYY-MM-DD` format.
sport	query	Да	integer	Sport id. Currently only football is exposed by `/sports`.

Ответы

200 Matches for the requested UTC date.

object

dateобязательно

string:date

пример: "2026-06-06"

countобязательно

integer

itemsобязательно

array<object>

object

idобязательно

integer

пример: 1611243

dateобязательно

string:date-time

пример: "2026-06-06T18:00:00+00:00"

finishedобязательно

boolean

пример: false

scoreобязательно

object

countryобязательно

object

tournamentобязательно

object

seasonобязательно

object

homeобязательно

object

awayобязательно

object

400 Invalid query parameters.

object

codeобязательно

string

messageобязательно

string

{
  "code": "date_invalid",
  "message": "Invalid or missing date. Expected format: YYYY-MM-DD"
}

401 Missing or invalid API token.

object

codeобязательно

string

messageобязательно

string

{
  "code": "missing_token",
  "message": "No token provided"
}

429 Rate limit exceeded.

object

codeобязательно

string

messageобязательно

string

{
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded"
}

Заголовки: Retry-After, X-RateLimit-Limit, X-RateLimit-Window

get/prediction-filters

List prediction filters

Prediction Filters

Ответы

200 Prediction-based filters for the current API token user.

object

countобязательно

integer

itemsобязательно

array<object>

object

idобязательно

integer

пример: 11583

nameобязательно

string

пример: "Manual football"

sportобязательно

object

betTypeобязательно

string

пример: "Home"

statusобязательно

string

пример: "approved"

enum: disabled, approved

401 Missing or invalid API token.

object

codeобязательно

string

messageобязательно

string

{
  "code": "missing_token",
  "message": "No token provided"
}

429 Rate limit exceeded.

object

codeобязательно

string

messageобязательно

string

{
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded"
}

Заголовки: Retry-After, X-RateLimit-Limit, X-RateLimit-Window

post/predictions/search

Search existing predictions

Predictions

Тело запроса

object

filterIdобязательно

integer

пример: 11583

matchIdsобязательно

array<integer>

пример: [1611243,1611244]

{
  "filterId": 11583,
  "matchIds": [
    1611243,
    1611244
  ]
}

Ответы

200 Existing predictions for requested matches.

object

countобязательно

integer

itemsобязательно

array<object>

object

idобязательно

integer

пример: 10

filterIdобязательно

integer

пример: 11583

matchIdобязательно

integer

пример: 1611243

oddsобязательно

string

пример: "2.150000"

sourceобязательно

string

пример: "api"

enum: api, ui

createdAtобязательно

string:date-time

пример: "2026-06-06T12:00:00+00:00"

updatedAtобязательно

string:date-time

пример: "2026-06-06T12:05:00+00:00"

400 Validation error.

object

codeобязательно

string

messageобязательно

string

{
  "code": "invalid_json_body",
  "message": "Invalid JSON body"
}

401 Missing or invalid API token.

object

codeобязательно

string

messageобязательно

string

{
  "code": "missing_token",
  "message": "No token provided"
}

403 The current user cannot access this resource.

object

codeобязательно

string

messageобязательно

string

{
  "code": "pro_subscription_required",
  "message": "Prediction-based filters are available only for PRO subscription"
}

404 Filter or match not found.

object

codeобязательно

string

messageобязательно

string

{
  "code": "filter_not_found",
  "message": "Filter not found"
}

429 Rate limit exceeded.

object

codeобязательно

string

messageобязательно

string

{
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded"
}

Заголовки: Retry-After, X-RateLimit-Limit, X-RateLimit-Window

put/prediction-filters/{filterId}/matches/{matchId}/prediction

Create or update prediction odds

Predictions

Параметры

Название	Где	Обязательный	Тип	Описание
filterId	path	Да	integer	-
matchId	path	Да	integer	-

Тело запроса

object

oddsобязательно

string | number

пример: "2.15"

{
  "odds": "2.15"
}

Ответы

200 Created or updated prediction.

object

idобязательно

integer

пример: 10

filterIdобязательно

integer

пример: 11583

matchIdобязательно

integer

пример: 1611243

oddsобязательно

string

пример: "2.150000"

sourceобязательно

string

пример: "api"

enum: api, ui

createdAtобязательно

string:date-time

пример: "2026-06-06T12:00:00+00:00"

updatedAtобязательно

string:date-time

пример: "2026-06-06T12:05:00+00:00"

400 Validation error.

object

codeобязательно

string

messageобязательно

string

{
  "code": "invalid_json_body",
  "message": "Invalid JSON body"
}

401 Missing or invalid API token.

object

codeобязательно

string

messageобязательно

string

{
  "code": "missing_token",
  "message": "No token provided"
}

403 The current user cannot access this resource.

object

codeобязательно

string

messageобязательно

string

{
  "code": "pro_subscription_required",
  "message": "Prediction-based filters are available only for PRO subscription"
}

404 Filter or match not found.

object

codeобязательно

string

messageобязательно

string

{
  "code": "filter_not_found",
  "message": "Filter not found"
}

429 Rate limit exceeded.

object

codeобязательно

string

messageобязательно

string

{
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded"
}

Заголовки: Retry-After, X-RateLimit-Limit, X-RateLimit-Window

delete/prediction-filters/{filterId}/matches/{matchId}/prediction

Delete prediction

Predictions

Параметры

Название	Где	Обязательный	Тип	Описание
filterId	path	Да	integer	-
matchId	path	Да	integer	-

Ответы

204 Prediction deleted. The endpoint is idempotent.

400 Validation error.

object

codeобязательно

string

messageобязательно

string

{
  "code": "invalid_json_body",
  "message": "Invalid JSON body"
}

401 Missing or invalid API token.

object

codeобязательно

string

messageобязательно

string

{
  "code": "missing_token",
  "message": "No token provided"
}

403 The current user cannot access this resource.

object

codeобязательно

string

messageобязательно

string

{
  "code": "pro_subscription_required",
  "message": "Prediction-based filters are available only for PRO subscription"
}

404 Filter or match not found.

object

codeобязательно

string

messageобязательно

string

{
  "code": "filter_not_found",
  "message": "Filter not found"
}

429 Rate limit exceeded.

object

codeобязательно

string

messageобязательно

string

{
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded"
}

Заголовки: Retry-After, X-RateLimit-Limit, X-RateLimit-Window

Схемы

ErrorResponse

object

codeобязательно

string

messageобязательно

string

SportsResponse

object

countобязательно

integer

itemsобязательно

array<object>

object

idобязательно

integer

пример: 1

nameобязательно

string

пример: "football"

Sport

object

idобязательно

integer

пример: 1

nameобязательно

string

пример: "football"

MatchesResponse

object

dateобязательно

string:date

пример: "2026-06-06"

countобязательно

integer

itemsобязательно

array<object>

object

idобязательно

integer

пример: 1611243

dateобязательно

string:date-time

пример: "2026-06-06T18:00:00+00:00"

finishedобязательно

boolean

пример: false

scoreобязательно

object

countryобязательно

object

tournamentобязательно

object

seasonобязательно

object

homeобязательно

object

awayобязательно

object

Match

object

idобязательно

integer

пример: 1611243

dateобязательно

string:date-time

пример: "2026-06-06T18:00:00+00:00"

finishedобязательно

boolean

пример: false

scoreобязательно

object

countryобязательно

object

tournamentобязательно

object

seasonобязательно

object

homeобязательно

object

awayобязательно

object

Score

object

homeобязательно

integer

пример: null

awayобязательно

integer

пример: null

IdName

object

idобязательно

integer

nameобязательно

string

PredictionFiltersResponse

object

countобязательно

integer

itemsобязательно

array<object>

object

idобязательно

integer

пример: 11583

nameобязательно

string

пример: "Manual football"

sportобязательно

object

betTypeобязательно

string

пример: "Home"

statusобязательно

string

пример: "approved"

enum: disabled, approved

PredictionFilter

object

idобязательно

integer

пример: 11583

nameобязательно

string

пример: "Manual football"

sportобязательно

object

betTypeобязательно

string

пример: "Home"

statusобязательно

string

пример: "approved"

enum: disabled, approved

SearchPredictionsRequest

object

filterIdобязательно

integer

пример: 11583

matchIdsобязательно

array<integer>

пример: [1611243,1611244]

PutPredictionRequest

object

oddsобязательно

string | number

пример: "2.15"

PredictionsResponse

object

countобязательно

integer

itemsобязательно

array<object>

object

idобязательно

integer

пример: 10

filterIdобязательно

integer

пример: 11583

matchIdобязательно

integer

пример: 1611243

oddsобязательно

string

пример: "2.150000"

sourceобязательно

string

пример: "api"

enum: api, ui

createdAtобязательно

string:date-time

пример: "2026-06-06T12:00:00+00:00"

updatedAtобязательно

string:date-time

пример: "2026-06-06T12:05:00+00:00"

Prediction

object

idобязательно

integer

пример: 10

filterIdобязательно

integer

пример: 11583

matchIdобязательно

integer

пример: 1611243

oddsобязательно

string

пример: "2.150000"

sourceобязательно

string

пример: "api"

enum: api, ui

createdAtобязательно

string:date-time

пример: "2026-06-06T12:00:00+00:00"

updatedAtобязательно

string:date-time

пример: "2026-06-06T12:05:00+00:00"