Referência

Documentação da API

Tudo que você precisa pra fazer a primeira chamada: autenticação, limites e cada endpoint com exemplo pronto.

Início rápido

Três passos até a primeira resposta ao vivo.

Crie sua conta gratuita e gere uma API key no painel.
Guarde a chave numa variável de ambiente (nunca no código).
Faça a chamada abaixo trocando pela sua chave.

curl

curl -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/fixtures"

Autenticação

A maioria dos endpoints usa uma API key no header X-API-Key. Cada chave carrega o tier do seu plano.

Endpoints de conta também aceitam um token JWT no header Authorization: Bearer, emitido no login.

Limites de uso

Cada resposta traz o seu saldo nos headers, então você nunca é pego de surpresa:

X-RateLimit-Limit: o limite do seu plano na janela atual
X-RateLimit-Remaining: quantas requisições ainda restam
X-RateLimit-Reset: quando a janela reinicia (epoch)

Endpoints de histórico e analytics custam mais por chamada (o badge de custo mostra o multiplicador).

Status

GET/api/v1/statusfree

Status do sistema de monitoramento

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/status"

GET/api/healthpúblico

Health check do sistema

curl

curl \
  "https://api.skull-api.xyz/api/health"

Partidas

GET/api/v1/fixturesfree

Listar partidas ao vivo

Parâmetro	Onde	Obrigatório
include_markets	query	não
status	query	não
limit	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/fixtures"

GET/api/v1/fixtures/{fixture_id}free

Obter detalhes de uma partida

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
include_markets	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/fixtures/<fixture_id>"

GET/api/v1/fixtures/{fixture_id}/eventsfree

Obter eventos/gols de uma partida (tempo real)

Parâmetro	Onde	Obrigatório
fixture_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/fixtures/<fixture_id>/events"

GET/api/v1/fixtures/{fixture_id}/statsfree

Obter estatísticas do jogo

Parâmetro	Onde	Obrigatório
fixture_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/fixtures/<fixture_id>/stats"

GET/api/v1/livefree

Listar partidas ao vivo (alias)

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/live"

Mercados

GET/api/v1/fixtures/{fixture_id}/marketsbasic

Obter mercados de uma partida

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
market_type	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/fixtures/<fixture_id>/markets"

Settlement

GET/api/v1/fixtures/{fixture_id}/settlementfree

Resultado do settlement de uma partida

Parâmetro	Onde	Obrigatório
fixture_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/fixtures/<fixture_id>/settlement"

Histórico

GET/api/v1/history/fixturesbasic2× custo

Buscar partidas históricas

Parâmetro	Onde	Obrigatório
start_date	query	não
end_date	query	não
team	query	não
status	query	não
min_score	query	não
max_score	query	não
sort_by	query	não
sort_order	query	não
limit	query	não
offset	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/history/fixtures"

GET/api/v1/history/fixtures/{fixture_id}basic

Obter histórico de uma partida

Parâmetro	Onde	Obrigatório
fixture_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/history/fixtures/<fixture_id>"

GET/api/v1/history/fixtures/{fixture_id}/oddspro3× custo

Obter histórico de odds

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
market	query	não
selection	query	não
interval	query	não
aggregation	query	não
include_statistics	query	não
limit	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/history/fixtures/<fixture_id>/odds"

GET/api/v1/history/fixtures/{fixture_id}/eventsbasic

Obter eventos de uma partida

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
event_type	query	não
limit	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/history/fixtures/<fixture_id>/events"

GET/api/v1/history/fixtures/{fixture_id}/movementspro2× custo

Obter movimentos significativos de odds

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
min_movement_pct	query	não
limit	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/history/fixtures/<fixture_id>/movements"

Analytics

GET/api/v1/analytics/fixtures/{fixture_id}/statisticspro3× custo

Obter estatísticas de odds

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
market	query	não
selection	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/analytics/fixtures/<fixture_id>/statistics"

GET/api/v1/analytics/fixtures/{fixture_id}/comparisonpro3× custo

Comparar mercados

Parâmetro	Onde	Obrigatório
fixture_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/analytics/fixtures/<fixture_id>/comparison"

GET/api/v1/analytics/fixtures/{fixture_id}/volatilitypro3× custo

Análise de volatilidade

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
market	query	não
interval	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/analytics/fixtures/<fixture_id>/volatility"

GET/api/v1/analytics/fixtures/{fixture_id}/ohlcpro3× custo

Dados OHLC para Candlestick

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
market	query	sim
selection	query	sim
interval	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/analytics/fixtures/<fixture_id>/ohlc?market=<market>&selection=<selection>"

GET/api/v1/analytics/fixtures/{fixture_id}/timeseriespro2× custo

Série temporal de odds

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
market	query	não
selection	query	não
limit	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/analytics/fixtures/<fixture_id>/timeseries"

GET/api/v1/analytics/fixtures/{fixture_id}/selectionspro

Listar mercados e seleções disponíveis

Parâmetro	Onde	Obrigatório
fixture_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/analytics/fixtures/<fixture_id>/selections"

GET/api/v1/analytics/fixtures/{fixture_id}/exportpro5× custo

Exportar dados para CSV

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
market	query	não
selection	query	não
include_events	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/analytics/fixtures/<fixture_id>/export"

Métricas

GET/api/v1/metrics/healthbasic

Status do sistema de métricas

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/metrics/health"

GET/api/v1/metrics/leaguesbasic2× custo

Métricas de ligas

Parâmetro	Onde	Obrigatório
window	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/metrics/leagues"

GET/api/v1/metrics/leagues/{league_name}basic

Métricas de uma liga específica

Parâmetro	Onde	Obrigatório
league_name	path	sim
window	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/metrics/leagues/<league_name>"

GET/api/v1/metrics/playersbasic2× custo

Métricas de jogadores

Parâmetro	Onde	Obrigatório
window	query	não
limit	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/metrics/players"

GET/api/v1/metrics/players/{player_name}basic

Métricas de um jogador específico

Parâmetro	Onde	Obrigatório
player_name	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/metrics/players/<player_name>"

GET/api/v1/metrics/fair-oddspro2× custo

Odds justas por liga

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/metrics/fair-odds"

GET/api/v1/metrics/fair-odds/{league_name}pro

Odds justas de uma liga

Parâmetro	Onde	Obrigatório
league_name	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/metrics/fair-odds/<league_name>"

GET/api/v1/metrics/value-bets/{fixture_id}pro5× custo

Detectar value bets em uma partida

Parâmetro	Onde	Obrigatório
fixture_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/metrics/value-bets/<fixture_id>"

GET/api/v1/metrics/matchup/{player_a}/{player_b}pro2× custo

Fair odds hierarquicas de um par de jogadores

Parâmetro	Onde	Obrigatório
player_a	path	sim
player_b	path	sim
window	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/metrics/matchup/<player_a>/<player_b>"

GET/api/v1/strategiespro2× custo

Estrategias de apostas com performance auditavel

Parâmetro	Onde	Obrigatório
league	query	não
status	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/strategies"

GET/api/v1/strategies/{strategy_id}/entriespro3× custo

Historico de entradas de uma estrategia

Parâmetro	Onde	Obrigatório
strategy_id	path	sim
window	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/strategies/<strategy_id>/entries"

GET/api/v1/streak-strategiespro2× custo

Streak strategies baseadas em periodicidade

Parâmetro	Onde	Obrigatório
league	query	não
ready_only	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/streak-strategies"

GET/api/v1/streak-strategies/{strategy_id}pro

Detalhes de uma streak strategy

Parâmetro	Onde	Obrigatório
strategy_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/streak-strategies/<strategy_id>"

GET/api/v1/streak-strategies/{strategy_id}/entriespro3× custo

Histórico de entradas de uma streak strategy

Parâmetro	Onde	Obrigatório
strategy_id	path	sim
window	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/streak-strategies/<strategy_id>/entries"

WebSocket

GET/api/v1/ws/tokenfree

Obter token para WebSocket

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/ws/token"

POST/api/v1/ws/subscribe-token

Gerar subscription token para canal específico

Parâmetro	Onde	Obrigatório
channel	query	sim

curl

curl -X POST \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/ws/subscribe-token?channel=<channel>"

Futebol

GET/api/v1/football/fixtures

Jogos de futebol ao vivo

Parâmetro	Onde	Obrigatório
limit	query	não
freshness_seconds	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/football/fixtures"

GET/api/v1/football/fixtures/{event_id}/markets

Mercados e odds atuais de um jogo

Parâmetro	Onde	Obrigatório
event_id	path	sim
market_id	query	não
market_type	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/football/fixtures/<event_id>/markets"

GET/api/v1/football/fixtures/{event_id}/odds-history

Histórico de odds de uma seleção

Parâmetro	Onde	Obrigatório
event_id	path	sim
market_id	query	sim
selection_name	query	sim
special_bet_value	query	não
interval_seconds	query	não
limit	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/football/fixtures/<event_id>/odds-history?market_id=<market_id>&selection_name=<selection_name>"

GET/api/v1/football/fixtures/{event_id}/stats

Estatísticas ao vivo de um jogo

Parâmetro	Onde	Obrigatório
event_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/football/fixtures/<event_id>/stats"

Feed v2

GET/api/v2/feed/status

Status do Feed

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v2/feed/status"

GET/api/v2/feed/config

Configuração do Feed

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v2/feed/config"

PUT/api/v2/feed/config

Atualizar Configuração

curl

curl -X PUT \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v2/feed/config"

GET/api/v2/feed/fixtures

Listar Fixtures Transformadas

Parâmetro	Onde	Obrigatório
include_markets	query	não
status	query	não
limit	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v2/feed/fixtures"

GET/api/v2/feed/fixtures/{fixture_id}

Obter Fixture Transformada

Parâmetro	Onde	Obrigatório
fixture_id	path	sim
include_markets	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v2/feed/fixtures/<fixture_id>"

GET/api/v2/feed/fixtures/{fixture_id}/markets

Obter Mercados Transformados

Parâmetro	Onde	Obrigatório
fixture_id	path	sim

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v2/feed/fixtures/<fixture_id>/markets"

GET/api/v2/feed/live

Fixtures Ao Vivo

Parâmetro	Onde	Obrigatório
include_markets	query	não
limit	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v2/feed/live"

Conta

GET/api/v1/tiers

Catálogo público de planos

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/tiers"

GET/api/v1/accountfree

Obter informações da conta

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/account"

GET/api/v1/account/usagefree

Obter histórico de uso

Parâmetro	Onde	Obrigatório
start_date	query	não
end_date	query	não

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/account/usage"

GET/api/v1/account/api-keysfree

Listar API Keys

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/account/api-keys"

POST/api/v1/account/api-keysfree

Criar nova API Key

curl

curl -X POST \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/account/api-keys"

DELETE/api/v1/account/api-keys/{key_id}free

Revogar API Key

Parâmetro	Onde	Obrigatório
key_id	path	sim

curl

curl -X DELETE \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/account/api-keys/<key_id>"

POST/api/v1/auth/verify-emailpúblico

Confirmar email

curl

curl -X POST \
  "https://api.skull-api.xyz/api/v1/auth/verify-email"

GET/api/v1/auth/verification-status

Status de verificação do email

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/auth/verification-status"

POST/api/v1/auth/resend-verification

Reenviar email de verificação

curl

curl -X POST \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/auth/resend-verification"

GET/api/v1/account/billing

Resumo de billing (Lago)

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/account/billing"

Billing

POST/api/v1/account/subscription/cancel

Cancelar a assinatura ativa

curl

curl -X POST \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/account/subscription/cancel"

GET/api/v1/account/invoices

Histórico de faturas

curl

curl \
  -H "X-API-Key: $SKULL_API_KEY" \
  "https://api.skull-api.xyz/api/v1/account/invoices"