Documentación de la API

Solicitud

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

Método: get

Encabezados

Authorization = Bearer api_token
api_token - el token proporcionado para acceder a los datos de la API

Parámetros

product = surebets|middles|valuebets
Tipo de datos solicitados. Parámetro obligatorio.

source = bookies
Enumeración de IDs de casas de apuestas para las que se necesitan datos. Parámetro obligatorio.

sport = sports
Enumeración de IDs de deportes para los cuales se necesitan datos. Parámetro obligatorio.

limit = 25
Un límite en el número de entradas que se pueden obtener en una solicitud. Por defecto, este valor se establece en 25.

cursor = sort_by:id
Parámetro para navegar por los resultados de salida. Dependiendo de si necesitamos avanzar o retroceder en la lista, sort_by e id deben tomarse de los últimos o primeros registros de la salida actual. Por ejemplo, para la salida ubicada al final de la página con sort_by:id: 4609118910833099900, id:785141488 (suponemos que este es el ID de la última entrada en la salida), el parámetro cursor se vería así: cursor=4609118910833099900:785141488.
Agregar este parámetro a la solicitud significaría la salida de datos de la página siguiente (si el ID fue el último) o de la página anterior (si el ID fue el primero).

commissions = betfair:5,betdaq:1.5
Valores de comisión aplicados a las apuestas. En este ejemplo, se indica que se aplicará una comisión del 5 % a las ganancias en las apuestas en Betfair y una comisión del 1,5 % para Betdaq.

oddsFormat = eu|us|uk|my|hk|pr
Formato de visualización de cuotas.
eu - Europeo (decimal)
us - Americano
uk - Británico (fraccionario)
my - Malasio
hk - Hong Kong
pr - probabilidad

outcomes = 2|3
Número de resultados de surebet: puede ser 2 o 3. Si no se especifica el parámetro o se especifica otro valor (en lugar de 2 o 3), se mostrarán todas las variantes posibles.

min_group_size = 2
Número mínimo de cuotas utilizado para la comparación y el cálculo de valuebets: puede ser 2 o más. En JSON, el campo también se muestra como "similar_size", escrito después de "id".

Filtrado

Para valuebets:

group = off
Muestra todas las apuestas similares para el mismo evento y línea.

min-odds = 1.25 max-odds = 5
Filtrado por cuotas.

min-overvalue = 1.25 max-overvalue = 5
Por sobrevaloración.

min-probability = 100.2 max-probability = 1523.44
Por probabilidad.

Para surebets:

min-profit = 10 max-profit = 1000
Por ganancia.

min-roi = 10 max-roi = 100000
Por ROI.

hide-different-rules = true
Excluyendo surebets con diferentes reglas deportivas en las que existe la posibilidad de perder todas las apuestas involucradas.

Para middles:

min-m-ev = 1 max-m-ev = 2
Por valor esperado (EV).

min-m-k = 1.25 max-m-k = 5
Por cuotas.

min-m-bet = 1 max-m-bet = 10
Por pérdida al fallar (ya sea la ganancia de ganar solo una apuesta o la pérdida si ambas apuestas pierden).

min-m-win = 1 max-m-win = 10
Por ganancia al acertar (la ganancia al ganar dos apuestas).

min-probability = 100.2 max-probability = 1523.44
Por probabilidad estimada de acierto de middle.

Filtrado aplicable a todas las solicitudes de API:

startOf = 1 endOf = 3
Por hora de inicio del evento, en horas.

startAge = 1 endAge = 3
Por la antigüedad de surebet/valuebet/middle.

order = field_desc order = field_asc
Establece el orden de clasificación en ascendente o descendente. El campo debe especificarse mediante uno de los siguientes parámetros:

Por ejemplo: start_at_asc

Restricciones

No más de 2 solicitudes por segundo.

Ejemplos de solicitudes

https://api.apostasseguras.com/request?product=surebets&source=1xbet|pinnaclesports|parimatch|marathonbet&sport=Basketball|Football|Tennis https://api.apostasseguras.com/request?product=surebets&source=1xbet|pinnaclesports|parimatch|marathonbet&sport=Basketball|Football|Tennis&limit=10&cursor=4609118910833099900:785141488

Para verificar rápidamente que la API funciona, puede usar la herramienta de línea de comandos curl para realizar una solicitud:

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


Result

Datos generales

{
    /* Hora en que se generó la respuesta */
    updated_at: 1684171109017,
    
    /* Si es posible avanzar en la lista */
    can_forward: true,
    
    /* Si es posible retroceder en la lista */
    can_backward: false,
    
    /* El número de registros en la salida */
    limit: 25
}

Sección de apuestas

{
    /* ID de la apuesta */
    id: 460444138,

    /* Nombre del torneo como aparece en el sitio web de la casa de apuestas */
    tournament: "Counter-Strike - BLAST Paris Major",

    /* Nombres de los participantes como aparecen en el sitio web de la casa de apuestas */
    teams: ["Fnatic", "G2"],

    /* Sobrevaloración de la apuesta en el rango de 0 a 1. Si es 0, el valor aún no ha sido calculado */
    overvalue: 0,

    /* Probabilidad de ganar la apuesta en el rango de 0 a 1. Si es 0, el valor aún no ha sido calculado */
    probability: 0,

    /* Valor de las cuotas */
    value: 4.56,

    /* Comisión que la casa de apuestas toma de las ganancias. Dado en el rango de 0 a 1 */
    commission: 0,

    /* Nombre de la casa de apuestas */
    bk: "parimatch",

    /* ID del partido en el sistema */
    event_id: 460159166,

    /* Tipo de deporte */
    sport_id: "CounterStrike",
    
    /* Hora de inicio del partido según lo indicado en el sitio web de la casa de apuestas */
    time: 1684157400000,
    
    /*
    Hay tres tipos de elementos que describen la navegación a una apuesta en el sitio web de la casa de apuestas:
      event_nav - enlace al partido
      view_nav - enlace a un mercado específico (grupo de apuestas)
      stake_nav - enlace a una apuesta específica
    Si solo está presente event_nav, se utiliza como reemplazo de view_nav y stake_nav. Si event_nav y view_nav están presentes, pero stake\_nav está ausente, view\_nav sirve como reemplazo de stake_nav.
    Cada uno de estos elementos tiene la misma estructura interna. A continuación se muestra una descripción de uno de ellos - event_nav.
    Un elemento que describe la navegación a una apuesta en el sitio web de la casa de apuestas. Aquí se registra cualquier dato que pueda ser útil para obtener un enlace directo a un partido o una apuesta específica. 
    */
    "event_nav": {
    
        /* una indicación de que el enlace del evento puede abrirse desde un iframe */
       "direct": true,
        
        /* una lista de enlaces para abrir y llegar a la página deseada */
        "links": [
            
            //el primer enlace llamado "main"
            {
                /* nombre del enlace */
                "name": "main",

                /* descripción de la solicitud http */
                "link": {

                    /* método de la solicitud 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"
                },
                /* lista de nombres de enlaces para abrir con este */
                "requirements": ["x"]
            },

            //segundo enlace llamado "x"
            {
                /* nombre del enlace */
                "name": "x",

                /* solicitud http */
                "link": {

                    /* método de la solicitud http */
                    "method": "POST",

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

                    /* parámetros de la solicitud 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"
                    }
                }, 
                
                /* tiempo máximo de retraso entre la apertura de este enlace y el enlace anterior */
                "maxDelay": 1500
            }],
           
        /*
          Normalmente, los datos en esta sección son específicos de cada casa de apuestas, y deberá verificar cómo usar este campo si el código no proporciona instrucciones claras para una casa de apuestas específica.
          Entendemos que los usuarios de la API necesitan saber cómo realizar apuestas rápidamente, pero al vender la API no proporcionamos documentación detallada sobre cómo realizar acciones específicas con cada casa de apuestas.
          En el mejor de los casos, podemos ayudar a los usuarios proporcionando respuestas a preguntas específicas o, si es posible, agregar alguna información a los datos de salida que pueda ayudar con la navegación.
        */
        "markers": {
            "id": 2000863629,
            "inValue": 1.95,
            "bk": "marathonbet",
            "externalId": "441036222-126110536388",
            "eventId": "16407509"
        }
    }
    
    /* Descripción de las características de la apuesta */
    type: {
        /* Condición correspondiente al tipo de apuesta; un parámetro variable adicional que describe la apuesta */
        condition: "3.5", 
        
        /*
        Este parámetro indica el tipo de situación de juego en la que tiene lugar el evento.
        regular - la situación de juego predeterminada. Por ejemplo, apuestas en el resultado del partido.
        first - una situación de juego donde los equipos compiten por marcar el primer gol / saque de esquina / tarjeta, etc.
        № 2 - una situación de juego para el segundo gol / saque de esquina / tarjeta, etc.
        last - similar a la primera situación pero para el último gol / saque de esquina / tarjeta, etc.
        openingPartnership - en críquet, la mejor asociación inicial
        y así sucesivamente.
        */
        game: "regular", 
        
        /*
        Este parámetro determina los equipos a los que se aplica la apuesta y puede tomar valores tales como:
        overall - equipos locales y/o visitantes
        home - equipo local
        away - equipo visitante
        both - ambos equipos, visitante y local
        */
        base: "overall", 
        
        /*
        Un tipo de resultados contables sobre los cuales se acepta la apuesta.
        Gol, saque de esquina, tarjeta, cuadro, set, punto, etc. - todos entran en "variety".
        */
        variety: "map", 
        
        /*
        Período de tiempo o parte del juego para el cual se acepta la apuesta.
        Por ejemplo: tiempo extra, tiempo regular, periodo1, set1, etc. - todos ellos se consideran "periods".
        */
        periodo: "prórroga", 
        
        /*
        Este parámetro describe el significado lógico de la apuesta y puede tomar valores tales como:
        win1 - victoria del equipo 1
        win1RetX - victoria del equipo 1, pero si hay empate, la apuesta se devuelve
        win2 - victoria del equipo 2
        win2RetX - victoria del equipo 2, pero si hay empate, la apuesta se devuelve
        draw - empate
        over - más de
        under - menos de
        yes - sucede
        no - no sucede
        odd - impar
        even - par
        ah1 - hándicap asiático del equipo 1
        ah2 - hándicap asiático del equipo 2
        eh1 - hándicap europeo del equipo 1
        ehx - hándicap europeo en empate
        eh2 - hándicap europeo del equipo 2
        
        y otros
        Algunos tipos de apuestas pueden implicar condiciones adicionales. Por ejemplo, para las apuestas de más y menos es el número total,
        y para las apuestas ah1/ah2/eh1/ehx/eh2 es el valor del hándicap. Todos estos valores se incluirán en un parámetro de condición separado.
        */
        
        tipo: "over", 
        
        /*
        Este parámetro es responsable de representar apuestas en el formato back/lay, que se puede encontrar en intercambios de apuestas como Betfair.
        Por defecto, todas las apuestas tienen back=true, y este parámetro no está presente en la salida. Sin embargo, si una apuesta es una apuesta lay, entonces este parámetro tendrá el valor back:false.
        */
        back: true,

        /*
        Este parámetro es responsable de negar una apuesta, lo que significa que el jugador gana si el evento especificado NO ocurre.
        En este caso, la salida tendrá no:true. Por defecto, es no:false.
        */
        
        no: false,
    }
}

/valuebets

records - esta es la enumeración de apuestas que son apuestas de valor.

Sección general para /surebets y /middles

{
    /* código de ordenamiento, según el cual se devuelve el resultado */
    sort_by: 4609118910833099900

    /* id del registro (surebet/middle/valuebet) */
    id: 785141488,

    /* hora de inicio del evento de resultado relacionado con este surebet/middle */
    time: 1685835600000,

    /* hora de creación del surebet/middle */
    created: 1684229420000,

    /* número de surebets/middles relacionados con el grupo de apuestas especificado */
    group_size: 2, 
    
    /* colección de apuestas incluidas en el surebet */
    prongs: [...], 
    
    /* un campo opcional; su presencia indica que las apuestas en el surebet/middle pueden estar sujetas a diferentes reglas */
    rd: [[0], [1], [1]]
}

/surebets

{
     ...
    
    /* rentabilidad del surebet */
    profit: 11.2812, 
    
    /*  ROI (Retorno de la Inversión) del surebet */
    roi: 222.6584,
    
    /*
    una lista de banderas, donde cada bandera corresponde a prongs, y cada bandera puede tomar los siguientes valores:
    0 - apuestas regulares
    1 - apuestas probablemente generativas
    2 - apuestas claramente generativas
    Una apuesta generativa es una apuesta que genera un surebet.
    */
    generatives: "0,2"
}

/middles

{
    ...
    
    /* pérdida posible si solo una apuesta gana */
    bet: 0.2452,
    
    /* ganancia posible si ambas apuestas ganan */
    win: 0.5097,
    
    /* probabilidad de acertar un middle, es decir, cuando ambas apuestas ganan */
    probability: 0.3379,
    
    /* cuotas de middle, es decir, la relación entre ganancia potencial y pérdida potencial */
    overvalue: 1.0404,
    
    /*expectativa matemática del middle. Cuanto mayor sea, más ventajoso es el middle. */
    ev: 0.0099
}