Documentazione API

Richiesta

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

Metodo: get

Intestazioni

Authorization = Bearer api_token
api_token - the token provided to you to access the API data

Parametri

product = surebets|middles|valuebets
Tipo di dati richiesto. 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 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
Aggiungere questo parametro alla richiesta significherebbe che la uscita 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 (frazzionato)
my - Malese
hk - Hong Kong
pr - probabilità

risultati = 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".

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.

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:

min-odds = 1.25
max-odds = 5
Filtra 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).
I valori per i parametri di filtro devono essere specificati come percentuali. La risposta viene calcolata in base al fuso orario UTC, indipendentemente dal fuso orario del richiedente. 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 (VA). 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 si colpisce (il profitto quando si vincono due 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 successo della 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 dell'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 è calcolata in base all'UTC, indipendentemente dal fuso orario del richiedente.

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

order = field_desc
order = field_asc
Il campo deve essere specificato da uno dei seguenti parametri: Il campo deve essere specificato da uno dei seguenti parametri:

  • predefinito
    Valuebet:
  • start_at
  • probabilità
  • value
  • bk_probability
  • bk_margin
    Surebet:
  • start_at
  • created_at
  • roi
    Middle:
  • start_at
  • probabilità
  • scommessa
  • vincita
  • ev
  • k

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|10bet|pokerstars&sport=Football|Volleyball" -H "Authorization: Bearer api_token"


Risultato

Dati generali

{
    /* Tempo in cui la risposta è stata generata */
    updated_at: 1684171109017,
    
    /* Se è possibile andare avanti nell'elenco */
    can_forward: true,
    
    /* Se è possibile tornare indietro nell'elenco */
    can_backward: false,
    
    /* Il numero di record nell'output */
    limit: 25
}

Sezione scommesse

{
    /* Bet ID */
    id: 460444138,

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

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

    /* Sopravvalutazione della scommessa nella fascia da 0 a 1. Se 0, il valore non è ancora stato calcolato */
    overvalue: 0,

    /* Probabilità di vincere la scommessa nella fascia da 0 a 1. Se 0, il valore non è ancora stato calcolato */
    probability: 0,

    /* Valore delle quote */
    value: 4.56,

    /* Commissione che il bookmaker prende sulle vincite. Fornito nell'intervallo da 0 a 1 */
    commission: 0,

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

    /* ID incontro nel sistema */
    event_id: 460159166,

    /* Tipo di sport */
    sport_id: "CounterStrike",
    
    /* Orario di inizio dell'incontro come indicato sul sito del bookmaker */
    time: 1684157400000,
    
    /*
    Ci sono tre tipi di elementi che descrivono la navigazione a una scommessa sul sito del bookmaker:
      event_nav - link al match
      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 di 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 attesa tra l'apertura di questo link e il link precedente */
                "maxDelay": 1500
            }],
           
        /*
          In generale, i dati in questa sezione sono specifici per ogni bookmaker e dovrai controllare come utilizzare questo campo se il codice non fornisce istruzioni chiare per un bookmaker particolare.
          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 */
    type: {
        /* Condizione corrispondente al tipo di scommessa; un parametro variabile aggiuntivo che descrive la scommessa */
        condition: "3.5", 
        
        /*
        Questo parametro indica il tipo di situazione di gioco in cui si verifica 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 goal / calcio d'angolo / cartellino, ecc.
        nº 2 - una situazione di gioco per il secondo goal / calcio d'angolo / cartellino, ecc.
        last - simile alla prima situazione ma per l'ultimo goal / calcio d'angolo / cartellino, ecc.
        openingPartnership - nel cricket, la migliore apertura partnership
        e così via.
        */
        game: "regular", 
        
        /*
        Questo parametro determina le squadre a cui si applica la scommessa e può assumere valori come:
        overall - squadre in casa e/o in trasferta (ad esempio, il totale dell'incontro)
        home - squadra in casa
        away - squadra in trasferta
        both - sia le squadre in trasferta che quelle in casa (ad esempio, entrambe le squadre segnano)
        
        base: "overall", 
        
        /*
        Un tipo di risultati conteggiabili sui quali la scommessa è accettata.
        Gol, calcio d'angolo, cartellino, frame, set, punto, ecc. - - tutti rientrano in "variety."
        */
        variety: "map", 
        
        /*
        Periodo di tempo o parte del gioco per cui la scommessa è accettata.
        Ad esempio:  overtime, regularTime, period1, set1, ecc. - tutti sono considerati "periods."
        */
        period: "overtime", 
        
        /*
        Questo parametro descrive il significato logico della scommessa e può assumere valori come:
        win1 - victory of team 1
        win1RetX - vittoria della squadra 1, ma se si verifica un pareggio, la scommessa viene restituita
        win2 - vittoria della squadra 2
        win2RetX - vittoria della squadra 2, ma se si verifica un pareggio, la scommessa viene restituita
        draw - draw
        over - più di
        meno di - meno di
        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 maggiori e minori, è il numero totale,
        e per le scommesse ah1/ah2/eh1/ehx/eh2 è il valore del handicap. Tutti questi valori saranno inclusi in un parametro di condizione separato.
        */
        
        type: "over", 
        
        /*
        Questo parametro è responsabile della rappresentazione delle scommesse nel formato per/contro, che può essere trovato su scambi 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, secondo il quale il risultato viene restituito */
    sort_by: 4609118910833099900

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

    /* ora di inizio dell'evento di risultato che si riferisce a questo surebet/middle */
    time: 1685835600000,

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

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

/surebets

{
     ...
    
    /* redditività del surebet */
    profit: 11.2812, 
    
    /*  ROI (Ritorno sull'investimento) del surebet */
    roi: 222.6584,
    
    /*
    una lista di bandiere, dove ogni bandiera corrisponde a prong, e ogni bandiera 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 solo una scommessa vince */
    bet: 0.2452,
    
    /* possibile vincita se entrambe le scommesse vincono */
    win: 0.5097,
    
    /* probabilità di ottenere un middle, cioè quando entrambe le scommesse vincono */
    probability: 0.3379,
    
    /* quote del middle, cioè il rapporto di vincita potenziale rispetto a perdita potenziale */
    overvalue: 1.0404,
    
    /*aspettativa matematica del middle. Maggiore è, più vantaggioso è il middle. */
    ev: 0.0099
}