API de Esportes (v1)

URL base:

https://sportdataapi.cyou/api/v1

Introduçã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*stringID 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: true e oddsSuspended: true; o status continua live até 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.

MercadoselectionAposta
h2hMoneyline / vencedor · Resultadohome | away | draw (quando aplicável)Sim
spreadsHandicap / spread · Handicaphome | away (+ point)Sim
totalsTotal (mais/menos) · Totaisover | under (+ point)Sim
alternate_spreadsHandicaps alternativos · Handicaphome | away (+ point)Só odds
alternate_totalsTotais alternativos · Totaisover | under (+ point)Só odds
team_totalsTotais por equipe · Totaisteam|over | team|under (+ point)Só odds
bttsAmbos marcam · Golsyes | noSim
double_chanceDupla chance · Resultadohome/draw | home/away | draw/awaySim
draw_no_betEmpate anula · Resultadohome | awaySim
h2h_3_wayResultado 1X2 com empate · Resultadohome | draw | awaySó odds
correct_scorePlacar exato · GolsplacarSim
halftime_fulltimeIntervalo / final · Períodosresultado no intervalo + finalSó odds
player_goal_scorer_anytimeJogador marca a qualquer momento · Jogadoresnome do jogadorSim
player_goal_scorer_2plusJogador marca 2 ou mais gols · Jogadoresnome do jogadorSim
player_first_goal_scorerJogador marca o 1º gol · Jogadoresnome do jogador | noneSim
player_featured_goalJogador destaque marca · Jogadoresjogador|yes | jogador|noSim
player_featured_goals_overJogador destaque: gols (mais/menos) · Jogadoresjogador|over | jogador|under (+ point)Sim
player_to_receive_cardJogador recebe cartão · Jogadoresnome do jogadorSim
player_to_receive_red_cardJogador recebe cartão vermelho · Jogadoresnome do jogadorSim
first_goal_teamQuem marca o 1º gol · Golshome | away | noneSim
second_goal_teamQuem marca o 2º gol · Golshome | away | noneSim
player_shots_on_targetChutes no gol do jogador · Jogadoresover | under (+ point)Só odds
player_shotsChutes do jogador · Jogadoresover | 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, draw ou away (também aceita o nome real do time, 1, x, 2 e empate).
  • Dupla chance: home/draw, home/away ou draw/away (também aceita 1x, 12 e x2).
  • Faixa de gols: a-b = de a até b gols (ex.: 2-3), n = exatamente n gols, n+ = n ou mais. Em team_goal_range o time vem antes: home|1-2.
  • Mais/menos: over ou under, com a linha no campo point (1.5, 2.5, 3.5, 4.5 no jogo; 0.5, 1.5, 2.5 no 1º tempo).
  • Ambas marcam: yes ou no (aceita sim/nao).
  • Mercados _h1 contam só o 1º tempo e _h2 só 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.

marketselectionGanha 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.5Visitante vence e saem 3 ou mais gols
double_chance_totals"home/draw|under" + point 3.5Mandante 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.5Ambas 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

MercadoselectionAposta
h2hResultado final (1X2)home | away | drawSim · Pelo placar
double_chanceDupla chancehome/draw | home/away | draw/awaySim · Pelo placar
draw_no_betEmpate anulahome | 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 temposhome|yes | home|no | away|yes | away|noSim · Pelas estatísticas do jogo

Gols

MercadoselectionAposta
spreadsHandicap de golshome | 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 marcamyes | noSim · Pelo placar
odd_evenTotal de gols ímpar ou parodd | evenSim · Pelo placar
odd_even_15Gols até os 15 minutos: ímpar ou parodd | even (point = 15)Sim · Pelo minuto dos lances (gols/cartões)
penalty_awardedHaverá pênalti no jogo?yes | noSim · Pelas estatísticas do jogo
penalty_awarded_h2Haverá pênalti no 2º tempo?yes | noSim · Pelas estatísticas do jogo
first_penalty_goalPrimeira equipe a marcar de pênaltihome | away | none (point = 1)Sim · Pelas estatísticas do jogo
first_goal_teamQuem marca o 1º golhome | away | noneSim · Pela ordem dos gols
second_goal_teamQuem marca o 2º golhome | away | noneSim · Pela ordem dos gols
goals_racePrimeiro time a marcar N golshome | 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)

MercadoselectionAposta
goal_rangePartida — faixa de golsfaixa: 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 golsfaixa: 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 golsfaixa: 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 golshome|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º tempohome|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 golshome|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º tempohome|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º tempohome|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 golshome/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º tempohome/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º tempohome/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 marcamhome|yes | home|no | draw|yes | draw|no | away|yes | away|noSim · Pelo placar do período (todas as partes precisam bater)
h2h_btts_h1Resultado do 1º tempo + ambas marcam no 1º tempohome|yes | draw|no | away|yes ...Sim · Pelo placar do período (todas as partes precisam bater)
double_chance_bttsDupla chance + ambas marcamhome/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 golsyes|faixa | no|faixa (faixas de goal_range)Sim · Pelo placar do período (todas as partes precisam bater)

1º tempo

MercadoselectionAposta
penalty_awarded_h1Haverá pênalti no 1º tempo?yes | noSim · Pelas estatísticas do jogo
h2h_3_way_h1Vencedor do 1º tempohome | away | drawSim · Pelas estatísticas do jogo
h2h_3_way_h2Vencedor do 2º tempohome | away | drawSim · Pelas estatísticas do jogo
double_chance_h1Dupla chance do 1º tempohome/draw | home/away | draw/awaySim · 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º tempoyes | noSim · Pelas estatísticas do jogo
odd_even_h1Gols no 1º tempo: ímpar ou parodd | evenSim · Pelas estatísticas do jogo
odd_even_h2Gols no 2º tempo: ímpar ou parodd | evenSim · Pelas estatísticas do jogo

Escanteios

MercadoselectionAposta
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 escanteioshome | away (+ point)Sim · Pelos escanteios do jogo
corners_1x2Mais escanteios (1X2)home | away | drawSim · 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º tempohome | away | none (point = N)Sim · Pelas estatísticas do jogo
corners_racePrimeiro a N escanteioshome | away | none (point = N)Sim · Pelas estatísticas do jogo

Cartões

MercadoselectionAposta
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õeshome | 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 | noSim · Pelas estatísticas do jogo

Finalizações

MercadoselectionAposta
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º tempohome|over | away|under (+ point)Sim · Pelas estatísticas do jogo
shots_racePrimeiro a N finalizaçõeshome | away | none (point = N)Sim · Pelas estatísticas do jogo
shots_race_h1Primeiro a N finalizações no 1º tempohome | 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 timehome|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 timehome|over | away|under (+ point)Sim · Pelas estatísticas do jogo

Faltas

MercadoselectionAposta
total_foulsTotal de faltas (mais/menos) — só ao vivoover | under (+ point)Sim · Pelas estatísticas do jogo
team_foulsFaltas do time (mais/menos) — só ao vivohome|over | away|under (+ point)Sim · Pelas estatísticas do jogo

Jogadores

MercadoselectionAposta
player_goal_scorer_anytimeJogador marca a qualquer momentonome do jogador (outcomes[].name)Sim · Pelos lances do jogador (escalação oficial)
player_goal_scorer_2plusJogador marca 2 ou mais golsnome do jogador (outcomes[].name)Sim · Pelos lances do jogador (escalação oficial)
player_first_goal_scorerJogador marca o 1º gol do jogonome do jogador | noneSim · Pelos lances do jogador (escalação oficial)
player_featured_goalJogador destaque marcajogador|yes | jogador|noSim · 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ãonome do jogador (outcomes[].name)Sim · Pelos lances do jogador (escalação oficial)
player_to_receive_red_cardJogador recebe cartão vermelhonome do jogador (outcomes[].name)Sim · Pelos lances do jogador (escalação oficial)
player_shots_on_targetChutes no gol do jogadorover | under (+ point)Só odds
player_shotsChutes do jogadorover | 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 (ou none = 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; selection Jogador|yes, Jogador|no, Jogador|over ou Jogador|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. Selection home|yes, home|no, away|yes ou away|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 do point (selection yes ou no). 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 (selection odd ou even; 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 (selection home, draw ou away) 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 em total_shots_on_target / team_shots_on_target.
  • total_fouls / team_fouls: faltas cometidas, mais/menos, do jogo ou do time (categoria faltas). 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

Pagamentos de assinatura via Pix são gerados pelo gateway configurado no painel Bank. 1. POST /api/me/action com action=purchase gera uma cobrança. 2. O sistema recebe QR Code e copia-e-cola. 3. O gateway chama /api/webhooks/vibepay com x-signature. 4. Ao receber PAID/APPROVED/CONFIRMED, o pagamento vira approved e a assinatura é liberada automaticamente. 5. O endpoint /api/me/action com action=getPaymentStatus também consulta o status para o painel. No seu cliente/API de apostas, o fluxo é separado: POST /bets cria o bilhete e o webhook cadastrado em webhook_url recebe bet.settled com WIN, LOSS ou VOID.

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

401missing_api_key / invalid_api_keyChave ausente, inválida ou revogada
403domain_not_allowedA requisição veio de um domínio diferente do cadastrado
403league_not_in_planA liga não está incluída no seu plano
403sport_not_in_planO esporte não está incluído no seu plano
409odds_suspendedOdds bloqueadas (atualizando) — tente de novo em instantes
409odds_changedA odd mudou; o erro retorna a odd máxima atual
409market_decided / event_finishedMercado já decidido ou jogo encerrado
429daily_limit_reachedLimite diário do plano atingido (zera 00:00 UTC)
429rate_limitedMuitas requisições por minuto
Criar conta grátis

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