Documentação da API

Pedido

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

Método: get

Cabeçalhos

Authorization = Bearer api_token
api_token - o token fornecido para aceder aos dados da API

Parâmetros

product = surebets|middles|valuebets
Tipo de dados solicitados. Parâmetro obrigatório.

source = bookies
Enumeração de IDs de casas de apostas para as quais os dados devem ser solicitados. Parâmetro obrigatório.

sport = sports
Enumeração de IDs de desporto para os quais os dados devem ser solicitados. Parâmetro obrigatório.

limit = 25
Um limite no número de entradas que podem ser obtidas em um pedido. Por padrão, este valor é definido como 25.

cursor = sort_by:id
Parâmetro para navegar pelos resultados de saída. Dependendo de se precisamos avançar ou retroceder na lista, sort_by e id devem ser retirados dos últimos ou primeiros registos da saída atual. Por exemplo, para a saída localizada na parte inferior da página com sort_by:id: 4609118910833099900, id:785141488 (vamos supor que este seja o ID da última entrada na saída), o parâmetro cursor ficaria assim: cursor=4609118910833099900:785141488.
Adicionar este parâmetro ao pedido significa a saída de dados da próxima página (se o ID for o último) ou da página anterior (se o ID for o primeiro).

commissions = betfair:5,betdaq:1.5
Valores de comissão aplicados às apostas. Neste exemplo, é indicado que uma comissão de 5% será aplicada nos ganhos das apostas na Betfair e uma comissão de 1,5% na Betdaq.

oddsFormat = eu|us|uk|my|hk|pr
Formato de exibição das odds.
eu - Europeu (decimal)
us - Americano
uk - Britânico (fracionário)
my - Malaio
hk - Hong Kong
pr - probabilidade

outcomes = 2|3
Número de resultados para apostas seguras: pode ser 2 ou 3. Se o parâmetro não for especificado ou outro valor for especificado (em vez de 2 ou 3), todas as variantes possíveis serão exibidas.

min_group_size = 2
Número mínimo de odds usadas para comparação e cálculo de apostas de valor: pode ser 2 ou superior. No JSON, o campo também é exibido como "similar_size", escrito após "id".

Filtragem

Para apostas de valor:

group = off
Mostra todas as apostas semelhantes para o mesmo evento e linha.

min-odds = 1.25 max-odds = 5
Filtragem por odds.

min-overvalue = 1.25 max-overvalue = 5
Por sobrevalorização.

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

Para apostas seguras:

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

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

hide-different-rules = true
Excluindo apostas seguras com regras esportivas diferentes, onde há possibilidade de perder todas as apostas envolvidas.

Para margens:

min-m-ev = 1 max-m-ev = 2
Por Valor Esperado (VE).

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

min-m-bet = 1 max-m-bet = 10
Por perda em caso de falha (lucro ao ganhar uma aposta ou perda se ambas perderem).

min-m-win = 1 max-m-win = 10
Por lucro em caso de vitória (lucro ao ganhar ambas as apostas).

min-probability = 100.2 max-probability = 1523.44
Por probabilidade estimada de acerto da margem.

Filtragem aplicável a todos os pedidos da API:

startOf = 1 endOf = 3
Pelo horário de início do evento, em horas.

startAge = 1 endAge = 3
Pela idade da aposta segura/valor/margem.

order = field_desc order = field_asc
Define a ordem de classificação como ascendente ou descendente. O campo deve ser especificado por um dos seguintes parâmetros:

Por exemplo: start_at_asc

Restrições

Não mais do que 2 pedidos por segundo.

Exemplos de pedidos

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 rapidamente se a API está a funcionar, pode utilizar a ferramenta de linha de comando curl para fazer um pedido:

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


Result

Dados gerais

{
    /* Hora em que a resposta foi gerada */
    updated_at: 1684171109017,
    
    /* Se é possível avançar na lista */
    can_forward: true,
    
    /* Se é possível retroceder na lista */
    can_backward: false,
    
    /* O número de registos na saída */
    limit: 25
}

Seção de apostas

{
    /* ID da aposta */
    id: 460444138,

    /* Nome do torneio conforme aparece no site da casa de apostas */
    tournament: "Counter-Strike - BLAST Paris Major",

    /* Nomes dos participantes conforme aparecem no site da casa de apostas */
    teams: ["Fnatic", "G2"],

    /* Sobrevalorização da aposta no intervalo de 0 a 1. Se for 0, o valor ainda não foi calculado */
    overvalue: 0,

    /* Probabilidade de ganhar a aposta no intervalo de 0 a 1. Se for 0, o valor ainda não foi calculado */
    probability: 0,

    /* Valor das odds */
    value: 4.56,

    /* Comissão que a casa de apostas retém dos ganhos. Dado no intervalo de 0 a 1 */
    commission: 0,

    /* Nome da casa de apostas */
    bk: "parimatch",

    /* ID do evento no sistema */
    event_id: 460159166,

    /* Tipo de desporto */
    sport_id: "CounterStrike",
    
    /* Hora de início da partida conforme indicado no site da casa de apostas */
    time: 1684157400000,
    
    /*
    Existem três tipos de elementos que descrevem a navegação para uma aposta no site da casa de apostas:
      event_nav - link para o jogo
      view_nav - link para um mercado específico (grupo de apostas)
      stake_nav - link para uma aposta específica
    Se apenas o event_nav estiver presente, ele é usado como substituto para view_nav e stake_nav. Se event_nav e view_nav estiverem presentes, mas stake\_nav estiver ausente, view\_nav serve como substituto para stake_nav.
    Cada um desses elementos tem a mesma estrutura interna. Abaixo está a descrição de um deles - event_nav.
    Um elemento que descreve a navegação para uma aposta no site da casa de apostas. Quaisquer dados úteis para obter um link direto para um jogo ou uma aposta específica são registrados aqui. 
    */
    "event_nav": {
    
        /* uma indicação de que o link do evento pode ser aberto a partir de um iframe */
       "direct": true,
        
        /* uma lista de links a serem abertos para chegar à página desejada */
        "links": [
            
            //o primeiro link chamado "main"
            {
                /* nome do link */
                "name": "main",

                /* descrição do pedido http */
                "link": {

                    /*  método do pedido 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 nomes de links a serem abertos com este */
                "requirements": ["x"]
            },

            //segundo link chamado "x"
            {
                /* nome do link */
                "name": "x",

                /* pedido http */
                "link": {

                    /*  método do pedido http */
                    "method": "POST",

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

                    /* parâmetros do pedido 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"
                    }
                }, 
                
                /* tempo máximo de atraso entre a abertura deste link e o link anterior */
                "maxDelay": 1500
            }],
           
        /*
          Normalmente, os dados nesta seção são específicos para cada casa de apostas, e você precisará verificar como utilizar este campo caso o código não forneça instruções claras para uma casa de apostas específica.
          Entendemos que os utilizadores da API precisam saber como realizar apostas rapidamente, mas, ao vender a API, não fornecemos documentação detalhada sobre como realizar ações específicas com cada casa de apostas.
          No máximo, podemos ajudar os utilizadores respondendo a perguntas específicas ou, se possível, adicionar informações nos dados de saída que ajudem na navegação.
        */
        "markers": {
            "id": 2000863629,
            "inValue": 1.95,
            "bk": "marathonbet",
            "externalId": "441036222-126110536388",
            "eventId": "16407509"
        }
    }
    
    /* Descrição das características da aposta */
    type: {
        /* Condição correspondente ao tipo de aposta; um parâmetro variável adicional que descreve a aposta */
        condition: "3.5", 
        
        /*
        Este parâmetro indica o tipo de situação de jogo em que o evento ocorre.
        regular - a situação de jogo padrão. Por exemplo, apostas no resultado da partida.
        first - uma situação de jogo onde as equipas competem para marcar o primeiro golo / pontapé de canto / cartão, etc.
        Nº 2 - uma situação de jogo para o segundo golo / pontapé de canto / cartão, etc.
        last - semelhante à situação primeira, mas para o último golo / pontapé de canto / cartão, etc.
        openingPartnership - no críquete, a melhor parceria inicial,
        e assim por diante.
        */
        game: "regular", 
        
        /*
        Este parâmetro determina as equipas às quais a aposta se aplica e pode ter os seguintes valores:
        overall - equipas de casa e/ou visitantes casa (por exemplo, o total da partida)
        home - equipa da casa
        away - equipa visitante
        both - ambas as equipas (por exemplo, ambas as equipas marcarem)
        */
        base: "overall", 
        
        /*
        Um tipo de resultados contáveis sobre os quais a aposta é aceita.
        Golo, pontapé de canto, cartão, quadro, set, ponto, etc. - todos estão sob "variety".
        */
        variety: "map", 
        
        /*
        Período de tempo ou parte do jogo para o qual a aposta é aceita.
        Por exemplo: overtime, regularTime, period1, set1, etc. - todos são considerados "períods".
        */
        period: "overtime", 
        
        /*
        Este parâmetro descreve o significado lógico da aposta e pode ter valores como:
        win1 - vitória da equipa 1
        win1RetX - vitória da equipa 1, mas se ocorrer um empate, a aposta é devolvida
        win2 - vitória da equipa 2
        win2RetX - vitória da equipa 2, mas se ocorrer um empate, a aposta é devolvida
        draw - empate
        over - mais
        under - menos
        yes - ocorre
        no - não ocorre
        odd - impar
        even - par
        ah1 - handicap asiático da equipa 1
        ah2 - handicap asiático da equipa 2
        eh1 - handicap europeu da equipa 1
        ehx - handicap europeu no empate
        eh2 - handicap europeu da equipa 2
        
        e outros
        Alguns tipos de apostas podem implicar condições adicionais. Por exemplo, para apostas de mais e menos é o número total,
        e para apostas ah1/ah2/eh1/ehx/eh2 é o valor do handicap. Todos esses valores serão incluídos em um parâmetro de condição separado.
        */
        
        type: "mais", 
        
        /*
        Este parâmetro é responsável por representar apostas no formato back/lay, que pode ser encontrado em bolsas de apostas como a Betfair.
        Por padrão, todas as apostas têm back=true, e este parâmetro não está presente na saída. No entanto, se uma aposta for uma lay bet, então este parâmetro terá o valor back:false.
        */
        back: true,

        /*
        Este parâmetro é responsável por negar uma aposta, o que significa que o jogador ganha se o evento especificado NÃO ocorrer.
        Neste caso, a saída terá no:true. Por padrão, é no:false.
        */
        
        no: false,
    }
}

/apostas de valor

records - esta é a enumeração de apostas que são apostas de valor.

Seção geral para /apostas seguras e /médias

{
    /* código de ordenação, de acordo com o qual o resultado é retornado */
    sort_by: 4609118910833099900

    /* ID de registo (aposta segura/de intervalo/de valor) */
    id: 785141488,

    /* hora de início do evento relacionado a esta aposta segura/de intervalo */
    time: 1685835600000,

    /* hora de criação da aposta segura/de intervalo */
    created: 1684229420000,

    /* número de apostas seguras/de intervalo relacionadas ao grupo especificado de apostas */
    group_size: 2, 
    
    /* coleção de apostas incluídas na aposta segura */
    prongs: [...], 
    
    /* um campo opcional; sua presença indica que as apostas na aposta segura/de intervalo podem estar sujeitas a regras diferentes */
    rd: [[0], [1], [1]]
}

/apostas seguras

{ ...
    
    /* lucratividade da aposta segura */
    profit: 11.2812, 
    
    /*  ROI (Retorno sobre o Investimento) da aposta segura */
    roi: 222.6584,
    
    /*
    uma lista de bandeiras, onde cada bandeira corresponde aos prongs, e cada bandeira pode ter os seguintes valores:
    0 - apostas regulares
    1 - apostas provavelmente gerativas
    2 - apostas claramente gerativas
    Uma aposta gerativa é uma aposta que gera uma aposta segura.
    */ generatives: "0,2" }

/apostas de intervalo

{ ...
    
    /* possível perda se apenas uma aposta ganhar */
    bet: 0.2452,
    
    /* possível ganho se ambas as apostas ganharem */
    win: 0.5097,
    
    /* probabilidade de acertar um intervalo, ou seja, quando ambas as apostas ganham */
    probability: 0.3379,
    
    /* odds do intervalo, ou seja, a relação entre o ganho potencial e a perda potencial */
    overvalue: 1.0404,
    
    /*expectativa matemática do intervalo. Quanto maior for, mais vantajosa será o intervalo. */ ev: 0.0099 }