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
Elenco degli ID dei bookmaker per i quali è necessario richiedere i dati. 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 dei dati. 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 del risultato corrente. Ad esempio, per il risultato posizionato nella parte inferiore della pagina con sort_by:id: 4609118910833099900, id:785141488 (supponiamo che questo sia l'ID dell'ultimo elemento nel risultato), il parametro "cursor" sarebbe così: "cursor=4609118910833099900:785141488"
Aggiungendo questo parametro alla richiesta, si otterrebbe i dati risultanti 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 delle valuebet: può essere 2 o più. In JSON il campo viene visualizzato come "similar_size", scritto dopo "id".

Filtraggio

Tutti i filtri dell'API funzionano come quelli del sito web. Puoi sperimentare con diverse impostazioni di filtraggio sul sito web per determinare i valori dei parametri appropriati per le tue richieste API.

Per le valuebet:

group = off
Mostra tutte le scommesse simili per lo stesso evento e linea. Per impostazione predefinita, viene applicato “group=type”, il che significa che viene visualizzata solo una scommessa per un evento.

min-odds = 1.25 max-odds = 5
Filtraggio per quote. Il valore deve essere un numero compreso tra 1 e 100.000 (incluso).

min-overvalue = 1.25 max-overvalue = 5
Per sovravalutazione. Il valore deve essere un numero compreso tra 0 e 1.000.000 (incluso). Per ottenere il valore in eccesso visualizzato sul nostro sito web, applica la seguente formula: Valore in eccesso sul sito web = (Valore in eccesso da API - 1) * 100.

min-probability = 100.2 max-probability = 1523.44
Per probabilità. Il valore deve essere un numero compreso tra 0 e 10.000 (incluso).

Per surebet:

min-profit = 10 max-profit = 1000
Per profitto. Il valore deve essere un numero compreso tra -5 e 100.000 (incluso).

min-roi = 10 max-roi = 100000
Per ROI. Il valore deve essere un numero compreso tra 0 e 100.000.000 (incluso).

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

Per le middle:

min-m-ev = 1 max-m-ev = 2
Per Valore atteso (EV). Il valore deve essere un numero compreso tra -100.000.000 e 100.000.000 (incluso).

min-m-k = 1.25 max-m-k = 5
Per quote. Il valore deve essere un numero compreso tra 0 e 100.000 (incluso).

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). Il valore deve essere un numero compreso tra 0 e 10.000 (incluso).

min-m-win = 1 max-m-win = 10
Per profitto quando vincono entrambe le scommesse. Il valore deve essere un numero compreso tra 0 e 10.000 (incluso).

min-probability = 100.2 max-probability = 1523.44
Per Probabilità stimata di centrare un middle. Il valore deve essere un numero compreso tra 0 e 10.000 (incluso).

Filtraggio applicabile a tutte le richieste API:

startOf = 1 endOf = 3
Per orario d'inizio evento, in ore. È anche possibile impostare una combinazione di giorni, ore e minuti, ad esempio: startOf=PT15M = "15 minuti" startOf=PT10H = "10 ore" startOf=P2D = "2 giorni" startOf=P2DT3H4M = "2 giorni, 3 ore e 4 minuti" La risposta viene calcolata in base al fuso orario UTC, indipendentemente dal fuso orario del richiedente.

startAge = 1 endAge = 3
Per età di una surebet/valuebet/middle. Identico all'orario di inizio dell'evento.

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 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

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"


Risultato

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 nel risultato */
    limit: 25
}

Sezione scommesse

{
    /* Identificatore della scommessa */
    id: 460444138,

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

    /* Nomi dei partecipanti come appaiono sul sito della casa */
    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",

    /* Identificatore 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/od 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: false,

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