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

Todos os filtros na API funcionam da mesma forma que no site. Você pode experimentar diferentes configurações de filtro no site para determinar os valores de parâmetros apropriados para suas solicitações de API.

Para apostas de valor:

group = off
Mostra todas as apostas semelhantes para o mesmo evento e linha. Por padrão, "group=type" é aplicado, o que significa que apenas uma aposta por evento é exibida.

min-odds = 1.25 max-odds = 5
Filtragem por odds. O valor deve ser um número entre 1 e 100.000 (inclusive).

min-overvalue = 1.25 max-overvalue = 5
Por sobrevalorização. O valor deve ser um número entre 0 e 1.000.000 (inclusive). Para obter o valor overvalue conforme exibido em nosso site, aplique a seguinte fórmula: Overvalue no site = (Overvalue da API - 1) * 100.

min-probability = 100.2 max-probability = 1523.44
Por probabilidade. O valor deve ser um número entre 0 e 10.000 (inclusive).

Para apostas seguras:

min-profit = 10 max-profit = 1000
Por lucro. O valor deve ser um número entre -5 e 100.000 (inclusive).

min-roi = 10 max-roi = 100000
Por ROI. O valor deve ser um número entre 0 e 100.000.000 (inclusive).

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). O valor deve ser um número entre -100.000.000 e 100.000.000 (inclusive).

min-m-k = 1.25 max-m-k = 5
Por odds. O valor deve ser um número entre 0 e 100.000 (inclusive).

min-m-bet = 1 max-m-bet = 10
Por perda em caso de falha (lucro ao ganhar uma aposta ou perda se ambas perderem). O valor deve ser um número entre 0 e 10.000 (inclusive).

min-m-win = 1 max-m-win = 10
Por lucro em caso de vitória (lucro ao ganhar ambas as apostas). O valor deve ser um número entre 0 e 10.000 (inclusive).

min-probability = 100.2 max-probability = 1523.44
Por probabilidade estimada de acerto da margem. O valor deve ser um número entre 0 e 10.000 (inclusive).

Filtragem aplicável a todos os pedidos da API:

startOf = 1 endOf = 3
Pelo horário de início do evento, em horas. Também é possível definir uma combinação de dias, horas e minutos, por exemplo: startOf=PT15M → "15 minutos" startOf=PT10H → "10 horas" startOf=P2D → "2 dias" startOf=P2DT3H4M → "2 dias, 3 horas e 4 minutos" A resposta é calculada com base no UTC, independentemente do fuso horário do solicitante.

startAge = 1 endAge = 3
Pela idade da aposta segura/valor/margem. O mesmo vale para o horário de início do evento.

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 https://api.apostasseguras.com/request?product=valuebets&source=betbonanza&sport=Basketball|Handball|&min-odds=1.0&max-odds=2.75&min-probability=0.01&max-probability=100&min-overvalue=1.0&max-overvalue=50&limit=500&group=off

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: false,

        /*
        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 }