L'API di refertazione delle scommesse che ti dà il verdetto
Hai un elenco di scommesse e vuoi sapere quali hanno vinto. Invia l'evento, il mercato, la linea e il lato, e ricevi vinta, persa, nulla, mezza vinta o mezza persa, calcolato sul risultato finale per 172 mercati in 21 sport.
Inclusa in tutti i piani a pagamento. Ogni chiamata conta come una richiesta.
- Mercati
- 172
- Sport
- 21
- Scommesse per richiesta
- 50
- Endpoint
- 2
Referta tre scommesse in una sola richiesta
Questa partita è finita 3-2 dopo 90 minuti e 3-3 dopo i supplementari. Nel calcio si referta sui 90 minuti, quindi il moneyline della squadra di casa è vinto, e basis mostra il punteggio usato.
curl -X POST "https://api.odds-api.io/v3/settlements/grade?apiKey=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"selections": [
{ "ref": "bet-1", "eventId": 74919888, "market": "ML", "side": "home" },
{ "ref": "bet-2", "eventId": 74919888, "market": "Spread", "hdp": -0.75, "side": "home" },
{ "ref": "bet-3", "eventId": 74919888, "market": "Totals", "hdp": 5.5, "side": "over" }
]
}'{
"grades": [
{ "ref": "bet-1", "eventId": 74919888, "result": "won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-2", "eventId": 74919888, "result": "half_won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-3", "eventId": 74919888, "result": "lost", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } }
]
}Come funziona la refertazione delle scommesse
Due endpoint. GET /v3/settlements ti dice cosa è successo in un massimo di 50 eventi. POST /v3/settlements/grade ti dice se le tue scommesse hanno vinto.
- 1
Salva la scommessa
Quando viene piazzata una scommessa, conserva l'id dell'evento, il mercato, la linea e il lato. Sono gli stessi quattro campi che ricevi già da /v3/odds, quindi non c'è nulla da mappare.
- 2
Inviala per la refertazione
Dopo la partita, invia con POST fino a 50 selezioni a /v3/settlements/grade. Ognuna torna come won, lost, void, half_won o half_lost. La maggior parte dei mercati sul punteggio restituisce anche il punteggio su cui si basa il verdetto.
- 3
Chiudi quando il risultato è definitivo
Ogni risposta include un flag final. Tieni da parte le selezioni con final a false e inviale di nuovo più tardi. Una volta al minuto è il massimo che serve.
Sette risposte possibili
Refertiamo una scommessa solo quando il risultato salvato dimostra la risposta. Se manca qualcosa o i conti non tornano, ricevi ungradeable con un motivo, mai un tentativo a caso.
- won
- La scommessa ha vinto
- lost
- La scommessa ha perso
- half_won
- Linea a quarti: metà della puntata vince, metà viene restituita
- half_lost
- Linea a quarti: metà della puntata perde, metà viene restituita
- void
- Puntata restituita. Il motivo è push o event_cancelled
- pending
- Non ancora decisa. Il motivo dice cosa stiamo aspettando
- ungradeable
- Non possiamo dimostrare la risposta. Il motivo spiega perché
Regole di refertazione che puoi leggere
Le regole seguono la prassi comune dei bookmaker. I bookmaker differiscono nei dettagli, quindi confrontale con i tuoi termini.
Il calcio si referta sui 90 minuti
I mercati di calcio, calcio a 5, pallamano e rugby si refertano sui tempi regolamentari. Supplementari e rigori non contano mai, anche quando il punteggio della partita li include.
Overtime dove i bookmaker lo contano
Nel basket, nel football americano, nel baseball e nell'hockey su ghiaccio, moneyline, spread e totali includono overtime e inning supplementari. 3-Way Result, Double Chance, Draw No Bet e i totali e spread Regulation si refertano sui tempi regolamentari.
Le linee a quarti dividono la puntata
Un handicap asiatico di -0.75 è metà su -0.5 e metà su -1. Se la squadra di casa vince di uno, la risposta è half_won. Una linea intera che cade esatta è void con motivo push.
Le partite annullate sono nulle
Ogni scommessa su un evento annullato torna void con motivo event_cancelled. Se la partita viene riprogrammata, l'evento torna pending con lo stesso id.
Calci d'angolo e cartellini dalle statistiche
Calci d'angolo, cartellini e prima squadra a segnare nel calcio vengono refertati dalle statistiche post-partita, circa 30 minuti dopo il fischio finale. Fino ad allora la risposta è pending con motivo awaiting_stats.
Props sui giocatori dal box score
Le props vengono refertate per basket, baseball, hockey su ghiaccio e football americano. Abbiniamo il giocatore per nome e ci rifiutiamo quando il nome potrebbe indicare due persone.
172 mercati in 21 sport
I nomi dei mercati sono quelli serviti da /v3/odds. La guida alla refertazione elenca ogni mercato per sport.
Linee principali
ML, 3-Way Result, Spread e handicap asiatici, Totals, Team Totals, European Handicap, Double Chance, Draw No Bet, Both Teams To Score, Odd/Even
Tempi, quarti e inning
Versioni primo tempo e secondo tempo delle linee principali, Half Time / Full Time, ogni quarto nel basket e nel football americano, ogni periodo nell'hockey su ghiaccio, mercati First 5 Innings e 1st Inning nel baseball
Tennis ed esports
Handicap game, totale game e game per giocatore, risultato in set, handicap set, vincente del set, totali per set e risultato esatto del set in tennis, pallavolo e tennis tavolo. Map Handicap, Total Maps, vincente della mappa e linee su round e kill per mappa negli esports, linee sui frame nello snooker
Statistiche del calcio
Calci d'angolo, cartellini, totale cartellini, tiri in porta, tiri, parate del portiere, fuorigioco, falli e contrasti, corsa ai corner, primo e ultimo corner, prima, ultima e dalla 2ª alla 5ª squadra a segnare, risultato esatto, margine di vittoria, gol esatti e gol per squadra, vittoria senza subire gol, porta inviolata
Props sui giocatori
Linee over e under dal box score ufficiale in basket, baseball, hockey su ghiaccio e football americano
Non ancora refertati
Mercati marcatori, props sui giocatori del calcio, linee delle freccette, cricket e antepost. Tornano come unsupported_market
Quanto spesso una scommessa viene refertata
Abbiamo passato in questa API 22,903 scommesse che il nostro bet tracker aveva refertato nei 30 giorni fino al 12 ottobre 2026. Questa è la quota che è tornata con un verdetto.
- Baseball, mercati sul punteggio
- 99.6%
- Hockey su ghiaccio, mercati sul punteggio
- 99.2%
- Basket, mercati sul punteggio
- 99.1%
- Football americano, mercati sul punteggio
- 98.5%
- Calcio, mercati sul punteggio
- 98.0%
- Cartellini nel calcio
- 88.3%
- Calci d'angolo nel calcio
- 82.4%
Prendi questi numeri come un'indicazione. Vengono da un mese di scommesse di un solo prodotto, soprattutto mercati principali del calcio, su eventi già refertati una volta. Il resto è tornato ungradeable con un motivo.
Domande frequenti sulla API di refertazione
Come refertare le scommesse in automatico con una API?
Salva l'id dell'evento, il mercato, la linea e il lato quando viene piazzata la scommessa. Dopo la partita, inviali a POST /v3/settlements/grade sulla API v3 di Odds-API.io. La risposta indica won, lost, void, half_won o half_lost per ogni scommessa, e il flag final ti dice quando il risultato è confermato.
Che cos'è una API di refertazione delle scommesse?
Una API di refertazione riceve una scommessa che hai e ti dice come è finita. Invii l'evento, il mercato, la linea e il lato, e restituisce il risultato in base al punteggio finale. La usano bet tracker, piattaforme di tipster, giochi di pronostici e back office dei bookmaker per non dover scrivere regole di refertazione per ogni mercato e sport.
Quali mercati e sport può refertare la API?
172 mercati in 21 sport: moneyline, spread e handicap asiatici, totali, goal/no goal, doppia chance, draw no bet, mercati del primo tempo, game e set del tennis, mappe degli esports, calci d'angolo, cartellini e ordine dei gol nel calcio, e props sui giocatori in basket, baseball, hockey su ghiaccio e football americano.
Può refertare scommesse con handicap asiatico a quarti?
Sì. Inviale come Spread con la linea in hdp. L'handicap è sempre espresso per la squadra di casa. Le linee a quarti come -0.75 restituiscono half_won o half_lost quando metà della puntata viene restituita, e una linea intera che cade esatta restituisce void con motivo push.
Una scommessa sul calcio si referta sui 90 minuti o dopo i supplementari?
Sui 90 minuti più recupero. Le scommesse su calcio, calcio a 5, pallamano e rugby si refertano sui tempi regolamentari, anche quando la partita è andata ai supplementari o ai rigori. Nella maggior parte dei mercati sul punteggio il verdetto include il punteggio su cui si basa, così puoi mostrarlo ai tuoi utenti. Half Time / Full Time, calci d'angolo, cartellini e props sui giocatori restituiscono solo il verdetto.
Cosa succede se una partita viene rinviata o annullata?
Nella maggior parte dei casi lo stato dell'evento diventa cancelled e ogni scommessa su di esso viene refertata void con motivo event_cancelled. Se la partita viene riprogrammata, l'evento torna pending con lo stesso id. Una partita che non ottiene mai un risultato diventa ungradeable con motivo result_unavailable 72 ore dopo il calcio d'inizio.
Quanto tempo dopo una partita posso refertare una scommessa?
I mercati sul punteggio di solito sono pronti pochi minuti dopo il fischio finale. Calci d'angolo, cartellini e props sui giocatori richiedono circa 30 minuti. Fino ad allora la risposta è pending. Il flag final diventa true quando il risultato è stato verificato con quello ufficiale, oppure 48 ore dopo la fine della partita.
Quali piani includono la API di refertazione?
Entrambi gli endpoint di refertazione sono inclusi in tutti i piani a pagamento e ogni chiamata conta come una richiesta. GET /v3/settlements accetta fino a 50 id evento e POST /v3/settlements/grade accetta fino a 50 selezioni.
Smetti di scrivere regole di refertazione
La refertazione arriva con la stessa chiave delle quote di 450+ bookmaker. Scegli un piano a pagamento e invia oggi le tue prime selezioni.