API de Esportes (v1)
URL base:
https://sportdataapi.cyou/api/v1Introdução
Ligas, campeonatos, jogos ao vivo, placares e odds em tempo real. Os dados são atualizados em segundos durante os jogos, e as odds mostram oddsSuspended: true quando estão bloqueadas para atualização. Todas as respostas são JSON no formato { ok, data } ou { ok: false, error }.
Autenticação
Envie sua chave no cabeçalho x-api-key. Pegue a chave no seu painel, em API Keys. Nunca exponha a chave em código público.
Proteção por domínio: se você cadastrar domínios no painel, só as requisições vindas desses domínios (cabeçalho Origin/Referer) serão aceitas. Chamadas de servidor sem Origin funcionam normalmente enquanto nenhum domínio estiver cadastrado.
Endpoints
Parâmetros — GET /events
| league* | string | ID da liga (de /leagues) |
Acréscimos (addedTime)
Em /events e /live, o campo addedTime vem null enquanto o acréscimo não foi anunciado. Quando o 4º árbitro mostra a placa, o campo passa a trazer os minutos exatos de cada tempo. Basta checar addedTime.announced a cada atualização. Se o acréscimo não for publicado, o campo continua null e o jogo segue normalmente pelo clock (ex.: 90'+3').
"clock": "90'+2'",
"addedTime": {
"firstHalf": 2, // minutos de acréscimo do 1º tempo (null se não anunciado)
"secondHalf": 5, // minutos de acréscimo do 2º tempo (null se não anunciado)
"announced": true
}Apostas e liquidação automática
Registre a aposta do seu usuário com POST /bets. Nós acompanhamos o placar e marcamos win assim que a condição for cumprida (mesmo com o jogo em andamento) ou loss quando ela não puder mais acontecer ou o jogo terminar. Linhas exatas (ex.: 2.0 com 2 gols) ficam void. Consulte o resultado em GET /bets.
- Pênaltis (
penalty_awarded,penalty_awarded_h1,penalty_awarded_h2,first_penalty_goal): contam pênaltis marcados (convertidos ou perdidos). Se a fonte do jogo não informar pênaltis, a aposta é anulada (void). - Primeiro a N escanteios no 1º tempo (
corners_race_h1): aberto antes do jogo e até os 20 minutos do 1º tempo. Cartões no 1º tempo:cards_totals_h1(amarelo = 1, vermelho = 2). - Jogo suspenso:
suspended: trueeoddsSuspended: true; o status continualiveaté o jogo voltar ou ser encerrado. - Ligas pelo LiveScore: Copa do Brasil, Copa do Brasil Feminina, LigaPro (Equador) e Liga FUTVE (Venezuela), com odds próprias (CloudFut). Placar, tempo, lances e estatísticas também usam o LiveScore quando a ESPN não reconhece o jogo.
Mercados disponíveis
A lista de jogos (/events, /live) traz os mercados principais que estiverem disponíveis. Os mercados adicionais — escanteios, cartões, períodos e jogadores — vêm em /events/{eventId}, no campo markets, já agrupados por category e com a melhor odd de cada opção. Cada casa oferece mercados diferentes; mostre apenas os que vierem na resposta. Nos mercados por time, a API substitui `home` e `away` pelo nome real do jogo: por exemplo, `Flamengo|over` ou `Palmeiras|over`. O campo `name` também vem como `Escanteios do time — Flamengo`, nunca como um time genérico.
Mercados para Futebol
A disponibilidade varia por liga e momento do jogo. Em partidas futuras, alguns mercados só aparecem quando as linhas são abertas. O endpoint /events/{eventId} devolve somente os mercados abertos daquele evento.
| Mercado | selection | Aposta |
|---|---|---|
| h2hMoneyline / vencedor · Resultado | home | away | draw (quando aplicável) | Sim |
| spreadsHandicap / spread · Handicap | home | away (+ point) | Sim |
| totalsTotal (mais/menos) · Totais | over | under (+ point) | Sim |
| alternate_spreadsHandicaps alternativos · Handicap | home | away (+ point) | Só odds |
| alternate_totalsTotais alternativos · Totais | over | under (+ point) | Só odds |
| team_totalsTotais por equipe · Totais | team|over | team|under (+ point) | Só odds |
| bttsAmbos marcam · Gols | yes | no | Sim |
| double_chanceDupla chance · Resultado | home/draw | home/away | draw/away | Sim |
| draw_no_betEmpate anula · Resultado | home | away | Sim |
| h2h_3_wayResultado 1X2 com empate · Resultado | home | draw | away | Só odds |
| correct_scorePlacar exato · Gols | placar | Sim |
| halftime_fulltimeIntervalo / final · Períodos | resultado no intervalo + final | Só odds |
| player_goal_scorer_anytimeJogador marca a qualquer momento · Jogadores | nome do jogador | Sim |
| player_goal_scorer_2plusJogador marca 2 ou mais gols · Jogadores | nome do jogador | Sim |
| player_first_goal_scorerJogador marca o 1º gol · Jogadores | nome do jogador | none | Sim |
| player_featured_goalJogador destaque marca · Jogadores | jogador|yes | jogador|no | Sim |
| player_featured_goals_overJogador destaque: gols (mais/menos) · Jogadores | jogador|over | jogador|under (+ point) | Sim |
| player_to_receive_cardJogador recebe cartão · Jogadores | nome do jogador | Sim |
| player_to_receive_red_cardJogador recebe cartão vermelho · Jogadores | nome do jogador | Sim |
| first_goal_teamQuem marca o 1º gol · Gols | home | away | none | Sim |
| second_goal_teamQuem marca o 2º gol · Gols | home | away | none | Sim |
| player_shots_on_targetChutes no gol do jogador · Jogadores | over | under (+ point) | Só odds |
| player_shotsChutes do jogador · Jogadores | over | under (+ point) | Só odds |
Mercados combinados (resultado + gols)
Os mercados da categoria combinados juntam duas condições numa única aposta. A selection tem as partes separadas por |, na ordem do nome do mercado. A aposta só ganha se todas as partes baterem.
- Resultado:
home,drawouaway(também aceita o nome real do time,1,x,2eempate). - Dupla chance:
home/draw,home/awayoudraw/away(também aceita1x,12ex2). - Faixa de gols:
a-b= de a até b gols (ex.:2-3),n= exatamente n gols,n+= n ou mais. Emteam_goal_rangeo time vem antes:home|1-2. - Mais/menos:
overouunder, com a linha no campopoint(1.5, 2.5, 3.5, 4.5 no jogo; 0.5, 1.5, 2.5 no 1º tempo). - Ambas marcam:
yesouno(aceitasim/nao). - Mercados
_h1contam só o 1º tempo e_h2só os gols do 2º tempo. Os demais valem para o tempo normal (90 min + acréscimos, sem prorrogação).
Em /events/{eventId} as opções vêm com o nome real dos times, por exemplo Flamengo/Draw|2-3 ou Palmeiras|Over com point: 2.5. Você pode enviar esse mesmo texto ou a forma com home/away. Só aparecem as opções ainda possíveis; ao vivo, faixas já estouradas somem da lista.
| market | selection | Ganha quando |
|---|---|---|
| goal_range | "2-3" | A partida termina com 2 ou 3 gols |
| goal_range_h1 | "0-1" | 0 ou 1 gol no 1º tempo |
| goal_range_h2 | "2+" | 2 ou mais gols só no 2º tempo |
| team_goal_range | "home|1-2" | Mandante marca 1 ou 2 gols |
| h2h_goal_range | "home|2-3" | Mandante vence e a partida tem 2 ou 3 gols |
| h2h_goal_range_h1 | "draw|0" | 1º tempo empatado em 0 a 0 |
| double_chance_goal_range | "home/draw|1-3" | Mandante ou empate, com 1 a 3 gols |
| h2h_totals | "away|over" + point 2.5 | Visitante vence e saem 3 ou mais gols |
| double_chance_totals | "home/draw|under" + point 3.5 | Mandante ou empate, com até 3 gols |
| h2h_btts | "home|yes" | Mandante vence e os dois times marcam |
| double_chance_btts | "draw/away|no" | Empate ou visitante, e pelo menos um time não marca |
| btts_totals | "yes|over" + point 2.5 | Ambas marcam e saem 3 ou mais gols |
| btts_goal_range | "yes|2-3" | Ambas marcam e a partida tem 2 ou 3 gols |
POST /bets { "league": "soccer_brazil_campeonato", "eventId": "<id>", "market": "h2h_goal_range", "selection": "home|2-3", "odds": 4.10, "stake": 10 }
POST /bets { "league": "soccer_brazil_campeonato", "eventId": "<id>", "market": "double_chance_totals", "selection": "home/draw|under", "point": 3.5, "odds": 1.62, "stake": 10 }
Liquidação: a aposta perde na hora se o placar já estourar a faixa, estourar o "menos" ou os dois times marcarem num "ambas: no". Nos demais casos é decidida ao fim do período. Se o placar do intervalo não for registrado, apostas de 1º/2º tempo são devolvidas (void).
Resultado
| Mercado | selection | Aposta |
|---|---|---|
| h2hResultado final (1X2) | home | away | draw | Sim · Pelo placar |
| double_chanceDupla chance | home/draw | home/away | draw/away | Sim · Pelo placar |
| draw_no_betEmpate anula | home | away (empate = void) | Sim · Pelo placar |
| h2h_15Vencedor até os 15 minutos (1X2) | home | draw | away (point = 15) | Sim · Pelo minuto dos lances (gols/cartões) |
| win_both_halvesTime vence os dois tempos | home|yes | home|no | away|yes | away|no | Sim · Pelas estatísticas do jogo |
Gols
| Mercado | selection | Aposta |
|---|---|---|
| spreadsHandicap de gols | home | away (+ point) | Sim · Pelo placar |
| totalsTotal de gols (mais/menos) | over | under (+ point) | Sim · Pelo placar |
| alternate_totalsTotal de gols (linhas alternativas) | over | under (+ point) | Sim · Pelo placar |
| team_totalsGols do time (mais/menos) | home|over | away|under (+ point) | Sim · Pelo placar |
| bttsAmbos marcam | yes | no | Sim · Pelo placar |
| odd_evenTotal de gols ímpar ou par | odd | even | Sim · Pelo placar |
| odd_even_15Gols até os 15 minutos: ímpar ou par | odd | even (point = 15) | Sim · Pelo minuto dos lances (gols/cartões) |
| penalty_awardedHaverá pênalti no jogo? | yes | no | Sim · Pelas estatísticas do jogo |
| penalty_awarded_h2Haverá pênalti no 2º tempo? | yes | no | Sim · Pelas estatísticas do jogo |
| first_penalty_goalPrimeira equipe a marcar de pênalti | home | away | none (point = 1) | Sim · Pelas estatísticas do jogo |
| first_goal_teamQuem marca o 1º gol | home | away | none | Sim · Pela ordem dos gols |
| second_goal_teamQuem marca o 2º gol | home | away | none | Sim · Pela ordem dos gols |
| goals_racePrimeiro time a marcar N gols | home | away | none (point = N) | Sim · Pelas estatísticas do jogo |
| goal_by_minuteGol até o minuto X (sim/não) | yes | no (+ point = minuto: 10, 15, 20, 30) | Sim · Pelo minuto dos lances (gols/cartões) |
| goal_h2_by_minuteGol no 2º tempo até o minuto X (sim/não) | yes | no (+ point = minuto: 60) | Sim · Pelo minuto dos lances (gols/cartões) |
Combinados (resultado + gols)
| Mercado | selection | Aposta |
|---|---|---|
| goal_rangePartida — faixa de gols | faixa: 0 | 1 | 2 | 3 | 4 | 0-1 | 0-2 | 1-2 | 1-3 | 2-3 | 2-4 | 3-4 | 3-5 | 4-5 | 4-6 | 2+ | 3+ | 4+ | 5+ | 6+ | Sim · Pelo placar do período (todas as partes precisam bater) |
| goal_range_h11º tempo — faixa de gols | faixa: 0 | 1 | 2 | 0-1 | 0-2 | 1-2 | 1-3 | 2-3 | 1+ | 2+ | 3+ | 4+ | Sim · Pelo placar do período (todas as partes precisam bater) |
| goal_range_h22º tempo — faixa de gols | faixa: 0 | 1 | 2 | 0-1 | 0-2 | 1-2 | 1-3 | 2-3 | 1+ | 2+ | 3+ | 4+ | Sim · Pelo placar do período (todas as partes precisam bater) |
| team_goal_rangeTime — faixa de gols | home|faixa | away|faixa (faixas: 0 | 1 | 2 | 3 | 0-1 | 0-2 | 1-2 | 1-3 | 2-3 | 2-4 | 1+ | 2+ | 3+ | 4+) | Sim · Pelo placar do período (todas as partes precisam bater) |
| team_goal_range_h1Time — faixa de gols no 1º tempo | home|faixa | away|faixa (mesmas faixas de team_goal_range) | Sim · Pelo placar do período (todas as partes precisam bater) |
| h2h_goal_rangeResultado + faixa de gols | home|faixa | draw|faixa | away|faixa (faixas de goal_range) | Sim · Pelo placar do período (todas as partes precisam bater) |
| h2h_goal_range_h1Resultado do 1º tempo + faixa de gols do 1º tempo | home|faixa | draw|faixa | away|faixa (faixas de goal_range_h1) | Sim · Pelo placar do período (todas as partes precisam bater) |
| h2h_goal_range_h2Resultado do 2º tempo + faixa de gols do 2º tempo | home|faixa | draw|faixa | away|faixa (faixas de goal_range_h2) | Sim · Pelo placar do período (todas as partes precisam bater) |
| double_chance_goal_rangeDupla chance + faixa de gols | home/draw|faixa | home/away|faixa | draw/away|faixa (faixas de goal_range) | Sim · Pelo placar do período (todas as partes precisam bater) |
| double_chance_goal_range_h1Dupla chance do 1º tempo + faixa de gols do 1º tempo | home/draw|faixa | home/away|faixa | draw/away|faixa (faixas de goal_range_h1) | Sim · Pelo placar do período (todas as partes precisam bater) |
| double_chance_goal_range_h2Dupla chance do 2º tempo + faixa de gols do 2º tempo | home/draw|faixa | home/away|faixa | draw/away|faixa (faixas de goal_range_h2) | Sim · Pelo placar do período (todas as partes precisam bater) |
| h2h_totalsResultado + total de gols (mais/menos) | home|over | draw|under | away|over ... (+ point 1.5 | 2.5 | 3.5 | 4.5) | Sim · Pelo placar do período (todas as partes precisam bater) |
| h2h_totals_h1Resultado do 1º tempo + gols do 1º tempo (mais/menos) | home|over | draw|under | away|over ... (+ point 0.5 | 1.5 | 2.5) | Sim · Pelo placar do período (todas as partes precisam bater) |
| double_chance_totalsDupla chance + total de gols (mais/menos) | home/draw|over | home/away|under | draw/away|over ... (+ point 1.5 | 2.5 | 3.5 | 4.5) | Sim · Pelo placar do período (todas as partes precisam bater) |
| h2h_bttsResultado + ambas marcam | home|yes | home|no | draw|yes | draw|no | away|yes | away|no | Sim · Pelo placar do período (todas as partes precisam bater) |
| h2h_btts_h1Resultado do 1º tempo + ambas marcam no 1º tempo | home|yes | draw|no | away|yes ... | Sim · Pelo placar do período (todas as partes precisam bater) |
| double_chance_bttsDupla chance + ambas marcam | home/draw|yes | home/away|no | draw/away|yes ... | Sim · Pelo placar do período (todas as partes precisam bater) |
| btts_totalsAmbas marcam + total de gols (mais/menos) | yes|over | yes|under | no|over | no|under (+ point 1.5 | 2.5 | 3.5 | 4.5) | Sim · Pelo placar do período (todas as partes precisam bater) |
| btts_goal_rangeAmbas marcam + faixa de gols | yes|faixa | no|faixa (faixas de goal_range) | Sim · Pelo placar do período (todas as partes precisam bater) |
1º tempo
| Mercado | selection | Aposta |
|---|---|---|
| penalty_awarded_h1Haverá pênalti no 1º tempo? | yes | no | Sim · Pelas estatísticas do jogo |
| h2h_3_way_h1Vencedor do 1º tempo | home | away | draw | Sim · Pelas estatísticas do jogo |
| h2h_3_way_h2Vencedor do 2º tempo | home | away | draw | Sim · Pelas estatísticas do jogo |
| double_chance_h1Dupla chance do 1º tempo | home/draw | home/away | draw/away | Sim · Pelas estatísticas do jogo |
| totals_h1Gols no 1º tempo (mais/menos) | over | under (+ point) | Sim · Pelas estatísticas do jogo |
| btts_h1Ambos marcam no 1º tempo | yes | no | Sim · Pelas estatísticas do jogo |
| odd_even_h1Gols no 1º tempo: ímpar ou par | odd | even | Sim · Pelas estatísticas do jogo |
| odd_even_h2Gols no 2º tempo: ímpar ou par | odd | even | Sim · Pelas estatísticas do jogo |
Escanteios
| Mercado | selection | Aposta |
|---|---|---|
| alternate_totals_cornersTotal de escanteios (mais/menos) | over | under (+ point) | Sim · Pelos escanteios do jogo |
| alternate_team_totals_cornersEscanteios do time (mais/menos) | home|over | away|under (+ point) | Sim · Pelos escanteios do jogo |
| alternate_spreads_cornersHandicap de escanteios | home | away (+ point) | Sim · Pelos escanteios do jogo |
| corners_1x2Mais escanteios (1X2) | home | away | draw | Sim · Pelos escanteios do jogo |
| corners_totals_h1Escanteios no 1º tempo (mais/menos) | over | under (+ point) | Sim · Pelas estatísticas do jogo |
| corners_race_h1Primeiro a N escanteios no 1º tempo | home | away | none (point = N) | Sim · Pelas estatísticas do jogo |
| corners_racePrimeiro a N escanteios | home | away | none (point = N) | Sim · Pelas estatísticas do jogo |
Cartões
| Mercado | selection | Aposta |
|---|---|---|
| card_by_minuteCartão até o minuto X (sim/não) | yes | no (+ point = minuto: 10, 15, 20, 30) | Sim · Pelo minuto dos lances (gols/cartões) |
| card_h2_by_minuteCartão no 2º tempo até o minuto X (sim/não) | yes | no (+ point = minuto: 60) | Sim · Pelo minuto dos lances (gols/cartões) |
| alternate_totals_cardsTotal de cartões (mais/menos) | over | under (+ point) | Sim · Pelos cartões (amarelos + vermelhos) |
| alternate_spreads_cardsHandicap de cartões | home | away (+ point) | Sim · Pelos cartões (amarelos + vermelhos) |
| cards_totals_h1Cartões no 1º tempo (mais/menos) | over | under (+ point) | Sim · Pelas estatísticas do jogo |
| red_cardHaverá cartão vermelho? | yes | no | Sim · Pelas estatísticas do jogo |
Finalizações
| Mercado | selection | Aposta |
|---|---|---|
| total_shotsTotal de finalizações (mais/menos) | over | under (+ point) | Sim · Pelas estatísticas do jogo |
| team_shotsFinalizações do time (mais/menos) | home|over | away|under (+ point) | Sim · Pelas estatísticas do jogo |
| total_shots_h1Finalizações no 1º tempo (mais/menos) | over | under (+ point) | Sim · Pelas estatísticas do jogo |
| team_shots_h1Finalizações do time no 1º tempo | home|over | away|under (+ point) | Sim · Pelas estatísticas do jogo |
| shots_racePrimeiro a N finalizações | home | away | none (point = N) | Sim · Pelas estatísticas do jogo |
| shots_race_h1Primeiro a N finalizações no 1º tempo | home | away | none (point = N) | Sim · Pelas estatísticas do jogo |
| total_shots_on_targetFinalizações no gol (mais/menos) | over | under (+ point) | Sim · Pelas estatísticas do jogo |
| team_shots_on_targetFinalizações no gol do time | home|over | away|under (+ point) | Sim · Pelas estatísticas do jogo |
| total_shots_off_targetFinalizações para fora (mais/menos) | over | under (+ point) | Sim · Pelas estatísticas do jogo |
| team_shots_off_targetFinalizações para fora do time | home|over | away|under (+ point) | Sim · Pelas estatísticas do jogo |
Faltas
| Mercado | selection | Aposta |
|---|---|---|
| total_foulsTotal de faltas (mais/menos) — só ao vivo | over | under (+ point) | Sim · Pelas estatísticas do jogo |
| team_foulsFaltas do time (mais/menos) — só ao vivo | home|over | away|under (+ point) | Sim · Pelas estatísticas do jogo |
Jogadores
| Mercado | selection | Aposta |
|---|---|---|
| player_goal_scorer_anytimeJogador marca a qualquer momento | nome do jogador (outcomes[].name) | Sim · Pelos lances do jogador (escalação oficial) |
| player_goal_scorer_2plusJogador marca 2 ou mais gols | nome do jogador (outcomes[].name) | Sim · Pelos lances do jogador (escalação oficial) |
| player_first_goal_scorerJogador marca o 1º gol do jogo | nome do jogador | none | Sim · Pelos lances do jogador (escalação oficial) |
| player_featured_goalJogador destaque marca | jogador|yes | jogador|no | Sim · Pelos lances do jogador (escalação oficial) |
| player_featured_goals_overJogador destaque: gols (mais/menos) | jogador|over | jogador|under (+ point 1.5) | Sim · Pelos lances do jogador (escalação oficial) |
| player_to_receive_cardJogador recebe cartão | nome do jogador (outcomes[].name) | Sim · Pelos lances do jogador (escalação oficial) |
| player_to_receive_red_cardJogador recebe cartão vermelho | nome do jogador (outcomes[].name) | Sim · Pelos lances do jogador (escalação oficial) |
| player_shots_on_targetChutes no gol do jogador | over | under (+ point) | Só odds |
| player_shotsChutes do jogador | over | under (+ point) | Só odds |
O catálogo abaixo detalha os mercados liquidados automaticamente pela plataforma. Todos os esportes usam o mesmo formato de bookmaker/market/outcomes.
Apostas de escanteios e cartões são liquidadas pelas estatísticas oficiais da partida; se o jogo não tiver estatísticas, a aposta fica void.
Odds próprias (CloudFut)
Todo jogo de futebol tem os mercados calculados pela plataforma, no pré-jogo e ao vivo: placar exato, 1X2, total, handicap de gols, dupla chance, empate anula, gols do time, ambos marcam, 1º/2º tempo, corrida de gols, escanteios, cartões, finalizações, pênaltis e os mercados de jogador. As probabilidades vêm da força dos times (odds de mercado, tabela da liga e jogos recentes) e são recalculadas a cada consulta com o placar e o minuto: saiu gol, as odds mudam na hora; mercado decidido sai da lista. Esses mercados vêm no bookmaker cloudfut e em markets.
Mercados de jogador
Disponíveis nas ligas com estatística suficiente (Brasileirão Série A e B, Copa do Brasil, Libertadores, Sul-Americana e grandes ligas da Europa). Os principais jogadores de cada time vêm da escalação oficial; antes dela sair, do último jogo do time na competição. Cada opção traz o nome do jogador em outcomes[].name e o time em outcomes[].description. As odds têm teto (padrão 15 para marcar/cartão e 26 para 1º a marcar/2+ gols).
player_goal_scorer_anytime: o jogador marca (selection = nome do jogador). Quem já marcou sai da lista.player_goal_scorer_2plus: marca 2 ou mais gols.player_first_goal_scorer: marca o 1º gol do jogo (ounone= sem gols). Fecha quando sai o 1º gol. Gol contra não conta.player_featured_goal/player_featured_goals_over: jogador destaque de cada time; selectionJogador|yes,Jogador|no,Jogador|overouJogador|under(point 1.5).player_to_receive_card/player_to_receive_red_card: o jogador recebe cartão (qualquer) / vermelho.first_goal_team/second_goal_team: time que marca o 1º / 2º gol (home, away ou none). Cada um fecha quando o gol sai.win_both_halves: o time vence o 1º e o 2º tempo. Selectionhome|yes,home|no,away|yesouaway|no. Se o time não venceu o 1º tempo, a aposta já é decidida no intervalo.goal_by_minute/card_by_minute: sai gol / cartão até o minuto dopoint(selectionyesouno). Pré-jogo: 10, 20 e 30 minutos. Ao vivo: só até 15 minutos, aberto nos primeiros 10 minutos do 1º tempo enquanto não houver gol/cartão.goal_h2_by_minute/card_h2_by_minute: sai gol / cartão no 2º tempo até o minuto 60 (point 60). Pré-jogo e ao vivo (do intervalo até os 55 minutos). Lances nos acréscimos do 1º tempo não contam.odd_even/odd_even_h1/odd_even_h2: total de gols do jogo / do 1º tempo / do 2º tempo é ímpar ou par (selectionoddoueven; 0 gols = par). Pré-jogo e ao vivo: a odd acompanha o placar e o minuto (quanto menos tempo resta, mais forte fica o lado do placar atual).h2h_15/odd_even_15: vencedor (selectionhome,drawouaway) e gols ímpar/par considerando só os gols até os 15 minutos (point 15). Pré-jogo e ao vivo até os 12 minutos do 1º tempo. Decidido pelo minuto dos gols; sem o minuto de algum gol, a aposta é anulada.total_shots_off_target/team_shots_off_target: finalizações para fora (total de finalizações menos as no gol), mais/menos, do jogo ou do time. Finalizações no gol continuam emtotal_shots_on_target/team_shots_on_target.total_fouls/team_fouls: faltas cometidas, mais/menos, do jogo ou do time (categoriafaltas). Só ao vivo e só quando a estatística de faltas dos dois times está disponível; sem faltas no fim do jogo, a aposta é anulada.- Os mercados por minuto são liquidados pelo minuto dos lances do jogo. Se houve gol/cartão mas o minuto não foi informado, a aposta é anulada (void).
Substituição: envie acceptSubstitution: true na aposta (ou em cada seleção da múltipla). Se o jogador for substituído antes de cumprir a aposta, passa a valer quem entrou no lugar dele (gols/cartões do substituto contam). Sem aceitar, jogador substituído antes de marcar = aposta perdida. Jogador fora da relação ou que não entrou em campo = devolvida (void). A escalação, as substituições e os lances por jogador estão em GET /lineups/{eventId}?league=.
Pagamentos e webhooks
Limites
Cada plano tem um limite de requisições por dia. Ao atingir o limite, a API responde 429 até o próximo dia. Acompanhe pelos cabeçalhos:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-Plan
Erros
| 401 | missing_api_key / invalid_api_key | Chave ausente, inválida ou revogada |
| 403 | domain_not_allowed | A requisição veio de um domínio diferente do cadastrado |
| 403 | league_not_in_plan | A liga não está incluída no seu plano |
| 403 | sport_not_in_plan | O esporte não está incluído no seu plano |
| 409 | odds_suspended | Odds bloqueadas (atualizando) — tente de novo em instantes |
| 409 | odds_changed | A odd mudou; o erro retorna a odd máxima atual |
| 409 | market_decided / event_finished | Mercado já decidido ou jogo encerrado |
| 429 | daily_limit_reached | Limite diário do plano atingido (zera 00:00 UTC) |
| 429 | rate_limited | Muitas requisições por minuto |
Exemplo — GET /events
curl --request GET \ --url 'https://sportdataapi.cyou/api/v1/events?league=soccer_brazil_campeonato' \ --header 'x-api-key: SUA_API_KEY'
Resposta
{
"ok": true,
"data": [
{
"id": "a1b2c3d4e5f6",
"league": "soccer_brazil_campeonato",
"homeTeam": "Flamengo",
"awayTeam": "Palmeiras",
"homeLogo": "https://sua-api.com/api/img/team/819",
"awayLogo": "https://sua-api.com/api/img/team/2029",
"commenceTime": "2026-10-02T22:00:00Z",
"status": "live",
"minute": 67,
"period": 2,
"halftime": false,
"clock": "67'",
"addedTime": null, // vira { "firstHalf": 2, "secondHalf": 5, "announced": true } quando anunciado
"score": { "home": 1, "away": 0 },
"halftimeScore": { "home": 1, "away": 0 },
"incidents": [
{ "type": "goal", "team": "home", "minute": "23'", "player": "Pedro" },
{ "type": "yellow_card", "team": "away", "minute": "41'", "player": "Gómez" }
],
"stats": {
"home": { "possession": 58, "shots": 11, "shotsOnTarget": 5, "corners": 6, "yellowCards": 1, "redCards": 0, "fouls": 9, "offsides": 2 },
"away": { "possession": 42, "shots": 7, "shotsOnTarget": 2, "corners": 3, "yellowCards": 2, "redCards": 0, "fouls": 12, "offsides": 1 }
},
"updatedAt": "2026-10-02T23:14:05Z",
"statusDetail": "67'", // texto da fonte: "HT", "FT", "Susp", "Int."...
"suspended": false, // true com o jogo suspenso/interrompido: status segue "live" e oddsSuspended vira true
"oddsSuspended": false,
"bookmakers": [
{
"key": "pinnacle",
"markets": [
{
"key": "h2h",
"outcomes": [
{ "name": "Flamengo", "price": 1.85 },
{ "name": "Draw", "price": 3.4 },
{ "name": "Palmeiras", "price": 4.2 }
]
},
{
"key": "totals",
"outcomes": [
{ "name": "Over", "price": 1.7, "point": 2.5 },
{ "name": "Under", "price": 2.1, "point": 2.5 }
]
}
]
}
]
}
]
}