Documentazione API

Richiesta

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

Metodo: get

Intestazioni

Authorization = Bearer api_token
api_token - il token fornito per accedere ai dati dell'API

Parametri

product = surebets|middles|valuebets
Tipo di dati richiesti. Parametro obbligatorio.

source = bookies
Enumeration of bookmaker IDs for which data needs to be requested. Parametro obbligatorio.

sport = sports
Elenco degli ID sportivi per i quali è necessario richiedere i dati. Parametro obbligatorio.

limit = 25
Limite sul numero di record ottenibili in una singola richiesta. Per impostazione predefinita, questo valore è impostato a 25.

cursor = sort_by:id
Parametro per navigare tra i risultati dell'output. A seconda che sia necessario procedere in avanti o indietro nell'elenco, sort_by e id devono essere presi dall'ultimo o dal primo record dell'output corrente. Ad esempio, per l'output posizionato nella parte inferiore della pagina con sort_by:id: 4609118910833099900, id:785141488 (supponiamo che questo sia l'ID dell'ultimo elemento nell'output), il parametro cursor sarebbe così: cursor=4609118910833099900:785141488
Aggiungendo questo parametro alla richiesta, si otterrebbe l'output dei dati della pagina successiva (se l'ID era l'ultimo) o della pagina precedente (se l'ID era il primo).

commissions = betfair:5,betdaq:1.5
Valori di commissione applicati alle scommesse. In questo esempio, è indicato che verrà applicata una commissione del 5% sulle vincite delle scommesse su Betfair e dell'1,5% su Betdaq.

oddsFormat = eu|us|uk|my|hk|pr
Formato di visualizzazione delle quote.
eu - Europeo (decimale)
us - Americano
uk - Britannico (frazionario)
my - Malese
hk - Hong Kong
pr - probabilità

outcomes = 2|3
Numero di risultati per surebet: può essere 2 o 3. Se il parametro non è specificato o è specificato un altro valore (anziché 2 o 3), verranno visualizzate tutte le varianti possibili.

min_group_size = 2
Numero minimo di quote utilizzate per il confronto e il calcolo dei valuebet: può essere 2 o più. In JSON il campo viene visualizzato come "similar_size", scritto dopo "id".

Filtraggio

Per valuebet:

group = off
Mostra tutte le scommesse simili per lo stesso evento e linea.

min-odds = 1.25 max-odds = 5
Filtraggio per quote.

min-overvalue = 1.25 max-overvalue = 5
Per sovravalutazione.

min-probability = 100.2 max-probability = 1523.44
Per probabilità.

Per surebet:

min-profit = 10 max-profit = 1000
Per profitto.

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

hide-different-rules = true
Escludendo surebet con regole sportive diverse in cui esiste la possibilità di perdere tutte le puntate coinvolte.

Per surebet:

min-m-ev = 1 max-m-ev = 2
Per Valore atteso (EV).

min-m-k = 1.25 max-m-k = 5
Per quote.

min-m-bet = 1 max-m-bet = 10
Per Perdita in caso di mancanza (o il profitto di una sola scommessa vinta o la perdita se entrambe le scommesse perdono).

min-m-win = 1 max-m-win = 10
Per profitto quando vincono entrambe le scommesse.

min-probability = 100.2 max-probability = 1523.44
Per Probabilità stimata di centrare un middle.

Filtraggio applicabile a tutte le richieste API:

startOf = 1 endOf = 3
Per orario di inizio evento, in ore.

startAge = 1 endAge = 3
Per età del surebet/valuebet/middle.

order = field_desc order = field_asc
Imposta l'ordine di ordinamento in ascendente o discendente. Il campo deve essere specificato da uno dei seguenti parametri:

Ad esempio: start_at_asc

Restrizioni

Non più di 2 richieste al secondo.

Esempi di richieste

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

Per verificare rapidamente che l'API funzioni, è possibile utilizzare lo strumento da riga di comando curl per effettuare una richiesta:

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


Result

Dati generali

{
    /* Orario di generazione della risposta */
    updated_at: 1684171109017,
    
    /* Se è possibile andare avanti nell'elenco */
    can_forward: true,
    
    /* Se è possibile andare indietro nell'elenco */
    can_backward: false,
    
    /* Numero di record nell'output */
    limit: 25
}

Sezione scommesse

{
    /* ID scommessa */
    id: 460444138,

    /* Nome del torneo come appare sul sito del bookmaker */
    tournament: "Counter-Strike - BLAST Paris Major",

    /* Nomi dei partecipanti come appaiono sul sito del bookmaker */
    teams: ["Fnatic", "G2"],

    /* Sovravalutazione della scommessa nell'intervallo da 0 a 1. Se è 0, il valore non è stato ancora calcolato */
    overvalue: 0,

    /* Probabilità di vincita della scommessa nell'intervallo da 0 a 1. Se è 0, il valore non è stato ancora calcolato */
    probability: 0,

    /* Valore della quota */
    value: 4.56,

    /* Commissione che il bookmaker preleva dalle vincite. Dati in un intervallo da 0 a 1 */
    commission: 0,

    /* Nome del bookmaker */
    bk: "parimatch",

    /* ID della partita nel sistema */
    event_id: 460159166,

    /* Tipo di sport */
    sport_id: "CounterStrike",
    
    /* Orario di inizio della partita come indicato sul sito del bookmaker */
    time: 1684157400000,
    
    /*
    Esistono tre tipi di elementi che descrivono la navigazione a una scommessa sul sito del bookmaker:
      event_nav - link alla partita
      view_nav - link a un mercato specifico (gruppo di scommesse)
      stake_nav - link a una scommessa specifica
    Se è presente solo event_nav, viene utilizzato come sostituto per view_nav e stake_nav. Se sono presenti event_nav e view_nav, ma stake\_nav è assente, view\_nav funge da sostituto per stake_nav.
    Ciascuno di questi elementi ha la stessa struttura interna. Di seguito è riportata una descrizione di uno di essi - event_nav.
    Un elemento che descrive la navigazione a una scommessa sul sito del bookmaker. Qualsiasi dato utile per ottenere un link diretto a una partita o a una scommessa specifica è registrato qui. 
    */
    "event_nav": {
    
        /* un'indicazione che il link dell'evento può essere aperto da un iframe */
       "direct": true,
        
        /* un elenco di link da aprire per raggiungere la pagina desiderata */
        "links": [
            
            //il primo link chiamato "main"
            {
                /* nome del link */
                "name": "main",

                /* descrizione della richiesta http */
                "link": {

                    /* metodo della richiesta 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"
                },
                /* elenco dei nomi dei link da aprire con questo */
                "requirements": ["x"]
            },

            //secondo link chiamato "x"
            {
                /* nome del link */
                "name": "x",

                /* richiesta http */
                "link": {

                    /* metodo della richiesta http */
                    "method": "POST",

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

                    /* parametri della richiesta 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 massimo di ritardo tra l'apertura di questo link e il link precedente */
                "maxDelay": 1500
            }],
           
        /*
          Di solito, i dati in questa sezione sono specifici di ciascun bookmaker, e sarà necessario verificare come utilizzare questo campo se il codice non fornisce istruzioni chiare per un determinato bookmaker.
          Comprendiamo che gli utenti dell'API devono sapere come piazzare le scommesse rapidamente, ma nella vendita dell'API non forniamo una documentazione dettagliata su come eseguire azioni specifiche con singoli bookmaker.
          Nel migliore dei casi, possiamo assistere gli utenti fornendo risposte a domande specifiche o, se possibile, aggiungere alcune informazioni ai dati di output che possono aiutare nella navigazione.
        */
        "markers": {
            "id": 2000863629,
            "inValue": 1.95,
            "bk": "marathonbet",
            "externalId": "441036222-126110536388",
            "eventId": "16407509"
        }
    }
    
    /* Descrizione delle caratteristiche della scommessa */
    tipo: {
        /* Condizione corrispondente al tipo di scommessa; un parametro variabile aggiuntivo che descrive la scommessa */
        condizione: "3.5", 
        
        /*
        Questo parametro indica il tipo di situazione di gioco in cui si svolge l'evento.
        regular - la situazione di gioco predefinita. Ad esempio, scommesse sul risultato della partita.
        first  - una situazione di gioco in cui le squadre competono per segnare il primo gol / calcio d'angolo / cartellino, ecc.
        № 2 - una situazione di gioco per il secondo gol / calcio d'angolo / cartellino, ecc.
        last - simile alla prima situazione ma per l'ultimo gol / calcio d'angolo / cartellino, ecc.
        openingPartnership - in cricket, la migliore partnership iniziale
        e così via.
        */
        game: "regular", 
        
        /*
        Questo parametro determina le squadre a cui si applica la scommessa e può assumere i seguenti valori:
        overall - squadre di casa e/o ospiti (ad esempio, il totale della partita)
        home - squadra di casa
        away - squadra ospite
        both - sia squadre ospiti che di casa (ad esempio, entrambe le squadre segnano)
        */
        base: "overall", 
        
        /*
        Un tipo di risultati contabili su cui viene accettata la scommessa.
        Gol, calcio d'angolo, cartellino, frame, set, punto, ecc. - rientrano tutti in "variety".
        */
        variety: "map", 
        
        /*
        Periodo di tempo o parte della partita per cui è accettata la scommessa.
        Ad esempio: overtime, regularTime, period1, set1, ecc. - tutti sono considerati "periods."
        */
        period: "overtime", 
        
        /*
        Questo parametro descrive il significato logico della scommessa e può assumere i seguenti valori:
        win1 - vittoria della squadra 1
        win1RetX - vittoria della squadra 1, ma in caso di pareggio, la scommessa viene restituita
        win2 - vittoria della squadra 2
        win2RetX - vittoria della squadra 2, ma in caso di pareggio, la scommessa viene restituita
        draw - pareggio
        over - superiore
        under - inferiore
        yes - accade
        no - non accade
        odd - dispari
        even - pari
        ah1 - handicap asiatico della squadra 1
        ah2 - handicap asiatico della squadra 2
        eh1 - handicap europeo della squadra 1
        ehx - handicap europeo sul pareggio
        eh2 - handicap europeo della squadra 2
        
        e altri
        Alcuni tipi di scommesse possono implicare condizioni aggiuntive. Ad esempio, per le scommesse over e under è il numero totale,
        e per le scommesse ah1/ah2/eh1/ehx/eh2 è il valore dell'handicap. Tutti questi valori saranno inclusi in un parametro di condizione separato.
        */
        
        type: "over", 
        
        /*
        Questo parametro è responsabile della rappresentazione delle scommesse nel formato back/lay, che può essere trovato su borse delle scommesse come Betfair.
        Per impostazione predefinita, tutte le scommesse hanno back=true, e questo parametro non è presente nell'output. Tuttavia, se una scommessa è lay, allora questo parametro avrà il valore back:false.
        */
        back: true,

        /*
        Questo parametro è responsabile della negazione di una scommessa, il che significa che il giocatore vince se l'evento specificato NON si verifica.
        In questo caso, l'output avrà no:true. Per impostazione predefinita, è no:false.
        */
        
        no: false,
    }
}

/valuebets

records - questa è l'enumerazione delle scommesse che sono valuebet.

Sezione comune per /surebets e /middles

{
    /* codice di ordinamento, in base al quale viene restituito il risultato */
    sort_by: 4609118910833099900

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

    /* orario di inizio dell'evento di esito relativo a questo surebet/middle */
    time: 1685835600000,

    /* orario di creazione del surebet/middle */
    created: 1684229420000,

    /* numero di surebet/middle relativi al gruppo specificato di scommesse */
    group_size: 2, 
    
    /* collezione di scommesse incluse nel surebet */
    prongs: [...], 
    
    /* un campo opzionale; la sua presenza indica che le scommesse nel surebet/middle possono essere soggette a regole diverse */
    rd: [[0], [1], [1]]
}

/surebets

{
     ...
    
    /* redditività del surebet */
    profit: 11.2812, 
    
    /* ROI (Return on Investment) del surebet */
    roi: 222.6584,
    
    /*
    un elenco di flag, dove ciascun flag corrisponde a prongs, e ogni flag può assumere i seguenti valori:
    0 - scommesse regolari
    1 - probabilmente scommesse generative
    2 - chiaramente scommesse generative
    Una scommessa generativa è una scommessa che genera un surebet.
    */
    generatives: "0,2"
}

/middles

{
    ...
    
    /* perdita possibile se vince solo una scommessa */
    bet: 0.2452,
    
    /* vincita possibile se vincono entrambe le scommesse */
    win: 0.5097,
    
    /* probabilità di centrare un middle, ovvero quando vincono entrambe le scommesse */
    probability: 0.3379,
    
    /* quote middle, ovvero il rapporto tra vincita potenziale e perdita potenziale */
    overvalue: 1.0404,
    
    /* aspettativa matematica del middle.probabilità Maggiore è, più vantaggioso è il middle. */
    ev: 0.0099
}