Documentação da API

Pedido

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

Método: get

Cabeçalhos

Autorização = Bearer api_token api_token - o token fornecido para aceder aos dados da API

Parâmetros

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

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

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

limite = 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).

comissões = 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
Odds display format.
eu - European (decimal)
us - American
uk - British (fractional)
my - Malaysian
hk - Hong Kong
pr - probability\

resultados = 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.

tamanho_min_grupo = 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:

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

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

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

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

Para apostas seguras:

lucro-mín = 10 lucro-máx = 1000 Por lucro.

roi-min = 10 roi-máx = 100000 Por ROI.

ocultar-regras-diferentes = 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: início_em_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.
        */ "marcadores": { "id": 2000863629, "inValue": 1.95, "bk": "marathonbet", "externalId": "441036222-126110536388", "eventId": "16407509" } /* Descrição das características da aposta */ tipo: { /* Condição correspondente ao tipo de aposta; um parâmetro variável adicional que descreve a aposta */ condição: "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.
        primeiro - 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.
        último - semelhante à situação primeira, mas para o último golo / pontapé de canto / cartão, etc.
        parceriaInicial - no críquete, a melhor parceria inicial,
        e assim por diante.
        */ jogo: "regular", /* Este parâmetro determina as equipas às quais a aposta se aplica e pode ter os seguintes valores: geral - equipas de casa e/ou visitantes casa - equipa da casa visitante - equipa visitante ambas - ambas as equipas */ base: "geral", /* 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 "variedade".
        */ variedade: "mapa", /* Período de tempo ou parte do jogo para o qual a aposta é aceita.
        Por exemplo: prolongamento, tempoRegulamentar, período1, set1, etc. - todos são considerados "períodos".
        */ período: "prolongamento", /* Este parâmetro descreve o significado lógico da aposta e pode ter valores como: vitória1 - vitória da equipa 1 vitória1RetX - vitória da equipa 1, mas se ocorrer um empate, a aposta é devolvida vitória2 - vitória da equipa 2 vitória2RetX - vitória da equipa 2, mas se ocorrer um empate, a aposta é devolvida empate - empate mais - mais menos - menos sim - ocorre não - não ocorre ímpar - ímpar par - 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.
        */ tipo: "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

registos - 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/margem/aposta de valor) */ id: 785141488, /* hora de início do evento relacionado a esta aposta segura/margem */ time: 1685835600000, /* hora de criação da aposta segura/margem */ created: 1684229420000, /* número de apostas seguras/margens 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/margem podem estar sujeitas a regras diferentes */ rd: [[0], [1], [1]]}

/apostas seguras

{ ...
    
    /* lucratividade da aposta segura */ lucro: 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.
    */ gerativos: "0,2" }

/médias

{ ...
    
    /* possível perda se apenas uma aposta ganhar */ aposta: 0.2452, /* possível ganho se ambas as apostas ganharem */ ganho: 0.5097, /* probabilidade de acertar uma margem, ou seja, quando ambas as apostas ganham */ probabilidade: 0.3379, /* odds da margem, ou seja, a relação entre o ganho potencial e a perda potencial */ sobrevalorização: 1.0404, /* expectativa matemática da margem. Quanto maior for, mais vantajosa será a média. */ ve: 0.0099 }