API документация

Содержание

Запрос
Параметры
Ограничения
Примеры запросов
Результат

Запрос

url: https://api.apostasseguras.com/request

Метод: get

Заголовки

Authorization = Bearerapi_token
api_token - токен, который вам предоставлен для получения API данных

Параметры

product =surebets|middles|valuebets
Тип запрашиваемых данных. Обязательный параметр.

source =bookies
Перечисление id букмекеров, для которых необходимо запросить данные. Обязательный параметр.

sport =sports
Перечисление id видов спорта, для которых необходимо запросить данные. Обязательный параметр.

limit =25
Лимит по числу данных, какие можно получить за один запрос. По умолчанию это значение равно 25.

cursor =sort_by:id
Параметр для навигации по результатам выдачи. В зависимости от того, нужно ли нам пойти вперед или назад по списку: sort_by и id должны быть взяты для последней или первой records текущей выдачи.
Например, для выдачи, которая имеется внизу страницы sort_by:id: 4609118910833099900, id:785141488 (допустим, это id последней записи в выдаче), параметр cursor будет выглядеть так:
cursor=4609118910833099900:785141488
Добавление этого параметра к запросу будет означать выдачу следующей (если id был последним) или предыдущей (если id был первым) страницы с данными.

commissions =betfair:5,betdaq:1.5
Значения применяемых к ставкам комиссий. В данном примере указано, что к выигрышам ставок на betfair будет применена комиссия в 5%, а для betdaq 1.5%.

oddsFormat =eu|us|uk|my|hk|pr
Формат отображения ставок.
eu - европейский (десятичный)
us - американский
uk - британский (дробный)
my - малазийский
hk - гонконгский
pr - вероятность

outcomes =2|3
Число исходов вилки: может быть 2 либо 3. Если параметр не указан или указано любое другое значение (кроме 2 либо 3), то будут отображаться все возможные варианты.

min_group_size =2
Минимальное число ставок для сравнения и расчета ставок с перевесом: может быть 2 и более. Также это поле отображается в JSON под именем "similar_size", записывается после "id".

Ограничения

Не более 2 запросов в секунду.

Примеры запросов

Чтобы быстро убедиться, что API работает, вы можете воспользоваться программой curl и выполнить там такой запрос:

curl "https://api.apostasseguras.com/request?product=surebets&source=bet365|22bet|unibet|pokerstars\_es&sport=Football|Volleyball" -H "Authorization: Bearerapi_token"

Результат

общие данные:

{
/* время: когда был сформирован ответ */
updated_at: 1684171109017,

/* есть ли возможность итерироваться вперед по списку */
can_forward: true,

/* есть ли возможность итерироваться назад по списку */
can_backward: false,

/* количество records в выдаче */
limit: 25
}

секция ставки:

{
/* id - ставки */
id: 460444138,

/* название турнира, как оно значится на букмекерском сайте */
tournament: "Counter-Strike - BLAST Paris Major",

/* названия участников, как они значатся на букмекерском сайте */
teams: ["Fnatic", "G2"],

/* переоценённость ставки в диапазоне от 0 до 1; если 0, то значение еще не посчитано */
overvalue: 0,

/* вероятность выигрыша ставки в диапазоне от 0 до 1; если 0, то значение еще не посчитано */
probability: 0,

/* коэффициент ставки */
value: 4.56,

/* комиссия, которую берет букмекер с выигрыша. Задана в диапазоне от 0 до 1 */
commission: 0,

/* название букмекерской конторы */
bk: "parimatch",

/* цифровой id матча в системе */
event_id: 460159166,

/* вид спорта */
sport_id: "CounterStrike",

/* время начала события, которое указал букмекерский сайт */
time: 1684157400000,

/*
Есть три типа элементов, которые описывают навигацию к ставке. Все они или какой-то из них могут присутствовать в выдаче, если их возможно получить для конкретного букмекера:
event_nav - ссылка до матча
view_nav - ссылка до конкретного маркета (группы ставок)
stake_nav - ссылка на конкретную ставку
При этом, если присутствует только event_nav, то этот же линк заменяет собой viewnav и stakenav. Если есть event_nav и view_nav, но нет stake_nav, то view_nav заменяет собой stake_nav.
Каждый из этих элементов имеет одинаковую внутреннюю структуру, поэтому ниже описан один из них - event_nav.
Элемент описания навигации к ставке на сайте букмекера. Сюда записываются любые данные, которые могут быть полезны для того, чтобы получить прямую ссылку на матч или конкретную ставку.
*/
"event_nav": {

   /* указание на то, что ссылка на событие может быть открыта из iframe */
   "direct": true,

   /* набор ссылок (links) */
   "links": [

       //первый link  с именем main
       {
           /* имя link */
           "name": "main",

           /* описание http-запроса */
           "link": {

               /* метод http-запроса */
               "method": "GET",

               /* url */
               "url": "https://www.marathonbet.com/en/betting/Tennis/ITF/England/Roehampton/Men/Singles/Round+of+32/B.Blaydes+vs+F.Bondioli+-+16407509"
           },

           /* список имен ссылок, которые должны быть открыты вместе с этой */
           "requirements": ["x"]
       },

       //второй линк с именем x
       {
           /* имя link */
           "name": "x",

           /* описание http-запроса */
           "link": {

               /* метод http-запроса */
               "method": "POST",

               /* url */
               "url": "https://www.marathonbet.com/en/betslip/add.htm",

               /* параметры http-запроса */
               "params": {
                   "ch": "{\"ewc\":\"1/1 1\",\"cid\":126110536388,\"prt\":\"CP\",\"ewf\":\"1.0\",\"epr\":\"1.95\",\"prices\":{\"0\":\"19/20\",\"1\":\"1.95\",\"2\":\"-106\",\"3\":\"0.95\",\"4\":\"0.95\",\"5\":\"-1.06\"},\"u\":\"15139400,Total_Games7.Under_23\",\"mainEventTreeId\":\"16407509\"}", 
                   "url": "https://www.marathonbet.com/en/betting/Tennis/ITF/England/Roehampton/Men/Singles/Round+of+32/B.Blaydes+vs+F.Bondioli+-+16407509"
               }
           }, 

           /* желательное максимальное время задержки между открытием этой ссылки и предыдущей */
           "maxDelay": 1500
       }],

   /*
     Обычно данные этого раздела индивидуальны для каждого букмекера, и вам придется уточнить, как использовать это поле, если код не предоставляет ясных указаний для конкретного букмекера.
     Мы понимаем, что для пользователей API важно знать, как быстро сделать ставку, однако, при продаже API мы не предоставляем подробной документации о том,
     как выполнять определенные действия с конкретными букмекерами.
     В лучшем случае мы можем помочь пользователям, предоставив ответы на конкретные вопросы, или, если возможно, добавить некоторую информацию в выходные данные, которая может облегчить им навигацию.
   */
   "markers": {
       "id": 2000863629,
       "inValue": 1.95,
       "bk": "marathonbet",
       "externalId": "441036222-126110536388",
       "eventId": "16407509"
   }

}

/* Описание характеристик для ставки /
type: {
/ условие, которое соответствует типу ставки, т.е. это дополнительный вариативный параметр, который описывает ставку */
condition: "3.5",

   /*
   Этот параметр отвечает за тип игровой ситуации, в рамках которого происходит событие.
   regular - это игровая ситуация по умолчанию. Например, в рамках такой ситуации принимаются ставки на исход матча
   first - игровая ситуация, в которой команды соревнуются в том, кто забьёт первый гол / подаст первый угловой / получит первую карточку и т.д.
   № 2 - игровая ситуация для второго гола / углового / карточки и т.д.
   last - аналогично ситуации first, только для последнего гола / углового / карточки и т.д.
   openingPartnership - в крикете лучшая стартовая пара
   и т.д.
   */
   game: "regular", 

   /*
   Этот параметр отвечает за команды, по отношению к которым принимается ставка, и может иметь такие значения, как:
   overall - домашняя и/или гостевая команды
   home - домашняя команда
   away - гостевая команда
   both - гостевая и домашняя команды
   */
   base: "overall", 

   /*
   разновидность исчисляемых значений, по которым принимается ставка
   гол, угловой, карточка, фрейм, сет, очко и т.д.  - все это будет variety
   */
   variety: "map", 

   /*
   период времени или часть игры, во время которого принимается ставка
   Например: overtime, regularTime, period1, set1 и т.д. - это все будет period
   */
   period: "overtime", 

   /*
   тип ставки. этот параметр описывает логический смысл ставки и может принимать значения вида:
   win1 - победа команды 1
   win1RetX - победа команды 1, но если ничья - возврат
   win2 - победа команды 2
   win2RetX - победа команды 2, но если ничья - возврат
   draw - ничья
   over - больше
   under - меньше
   yes - будет
   no - не будет
      odd - нечет
      even - чет
   ah1 - азиатский гандикап команды 1
   ah2 - азиатский гандикап команды 2
   eh1 - европейский гандикап команды 1
   ehx - европейский гандикап на ничью
   eh2 - европейский гандикап команды 2

   и другие
   Некоторые типы ставок могут подразумевать дополнительное условие. Например, для ставок over и under - это число total,
   для ставок типа ah1/ah2/eh1/ehx/eh2 - это число гандикапа; все такие значения будут идти в отдельном параметре condition.
   */

   type: "over", 

   /*
   параметр, отвечающий за представление ставок в формате back/lay, который может встречаться на биржах ставок типа Betfair.
   По умолчанию все ставки back=true, и этот параметр отсутствует в выдаче, но если ставка будет lay, то этот параметр будет иметь значение
   back:false
   */
   back: true,

   /*
   параметр, отвечающий за отрицания ставки, т.е. ставка описана таким образом, что игрок выигрывает, если описанное событие НЕ происходит. В этом случае в выдаче будет
   no:true. По умолчанию no:false.
   */

   no: false,

}
}

/valuebets

records это и есть перечисление ставок, которые valuebets

Общая часть у /surebets и /middles

{
/* код сортировки, согласно которому возвращен результат */
sort_by: 4609118910833099900

/* record (surebet/middle/valuebet) id */
id: 785141488,

/* время начала события исхода, которое относится к surebet/middle */
time: 1685835600000,

/* время возникновения surebet/middle */
created: 1684229420000,

/* число surebets/middles, которые относятся к заданной группе ставок */
group_size: 2,

/* коллекция ставок, входящих в surebet */
prongs: [...],

/* опциональное поле, наличие которого означает, что ставки в surebet/middle могут применяться по разным правилам */
rd: [[0], [1], [1]]
}

/surebets

{
...
/* доходность surebet */
profit: 11.2812,

/* roi surebet */
roi: 222.6584,

/*
список флагов, где каждый флаг соответствует prongs, при этом отдельный флаг может принимать значения:
0 - обычные ставки
1 - вероятно генеративные ставки
2 - явно генеративные ставки
генеративная ставка - это такая ставка, которая собой порождает surebet
*/
generatives: "0,2"
}

/middles

{
...
/* возможный проигрыш в случае, если сыграет только одна ставка */
bet: 0.2452,

/* возможный выигрыш, если сыграют сразу две ставки */
win: 0.5097,

/* вероятность попадания в коридор, т.е. того, что сыграют обе ставки */
probability: 0.3379,

/* коэффициент коридора, т.е. отношение возможного выигрыша к возможному проигрышу */
overvalue: 1.0404,

/*математическое ожидание middle. Чем оно выше, тем более выгоден middle */
ev: 0.0099
}