Autenticação
Todas as requisições da API requerem autenticação via uma chave de API. Sua chave começa com sk_ seguido por live_ ou test_.
Métodos de AutenticaçãoLink permanente para esta seção
A SharpAPI suporta três métodos de autenticação, listados em ordem de prioridade:
1. Cabeçalho X-API-Key (Recomendado)Link permanente para esta seção
O método mais seguro para aplicações server-side.
curl -H "X-API-Key: sk_live_your_key" \
https://api.sharpapi.io/api/v1/odds2. Cabeçalho Authorization BearerLink permanente para esta seção
Formato padrão de bearer token no estilo OAuth.
curl -H "Authorization: Bearer sk_live_your_key" \
https://api.sharpapi.io/api/v1/odds3. Parâmetro de ConsultaLink permanente para esta seção
Útil para streaming SSE em navegadores onde não é possível definir cabeçalhos personalizados.
curl "https://api.sharpapi.io/api/v1/stream?api_key=sk_live_your_key"Aviso de Segurança: Nunca exponha sua chave de API em código client-side ou em repositórios públicos. Use um proxy de backend para aplicações de navegador.
Obtendo Sua Chave de APILink permanente para esta seção
- Cadastre-se - Crie uma conta em sharpapi.io/sign-up
- Acesse o Dashboard - Faça login em seu dashboard
- Copie a Chave - Sua chave de API é exibida no dashboard principal
Pronto para fazer sua primeira chamada? Siga o guia Início Rápido.
Planos de AssinaturaLink permanente para esta seção
| Plano | Preço | Requisições/Min | Atraso de Dados | Principais Recursos |
|---|---|---|---|---|
| Free | $0/mês | 12 | 60s | Odds, Eventos |
| Hobby | $79/mês | 120 | Tempo real | Odds, Eventos, Arbitragem |
| Pro | $229/mês | 300 | Tempo real | + EV, Middles |
| Sharp | $399/mês | 1.000 | Tempo real | + Suporte Prioritário |
| Enterprise | Personalizado | Personalizado | Tempo real | + SLA |
Veja Preços para detalhes completos.
Limites de Taxa (Rate Limits)Link permanente para esta seção
Os limites de taxa são aplicados por chave de API. Os limites atuais são retornados nos cabeçalhos de resposta:
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1705804800| Cabeçalho | Descrição |
|---|---|
X-RateLimit-Limit | Máximo de requisições por minuto para o seu plano |
X-RateLimit-Remaining | Requisições restantes na janela atual |
X-RateLimit-Reset | Timestamp Unix de quando o limite é redefinido |
Resposta de Limite de TaxaLink permanente para esta seção
Quando excedido, você receberá uma resposta 429:
{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Upgrade your plan or wait before retrying.",
"docs": "https://docs.sharpapi.io/en/authentication#rate-limits"
}
}Implemente backoff exponencial ao receber uma resposta 429. Verifique X-RateLimit-Reset para saber quando a janela é redefinida.
Acesso a Recursos por PlanoLink permanente para esta seção
| Recurso | Free | Hobby | Pro | Sharp | Enterprise |
|---|---|---|---|---|---|
GET /odds | Sim | Sim | Sim | Sim | Sim |
GET /odds/best | Sim | Sim | Sim | Sim | Sim |
GET /odds/comparison | Sim | Sim | Sim | Sim | Sim |
POST /odds/batch | Sim | Sim | Sim | Sim | Sim |
GET /events | Sim | Sim | Sim | Sim | Sim |
GET /events/:eventId | Sim | Sim | Sim | Sim | Sim |
GET /events/:eventId/odds | Sim | Sim | Sim | Sim | Sim |
GET /events/:eventId/markets | Sim | Sim | Sim | Sim | Sim |
GET /opportunities/ev | Não | Não | Sim | Sim | Sim |
GET /opportunities/arbitrage | Não | Sim | Sim | Sim | Sim |
GET /opportunities/middles | Não | Não | Sim | Sim | Sim |
GET /stream | Não | Add-on | Add-on | Add-on | Sim |
GET /account | Sim | Sim | Sim | Sim | Sim |
GET /account/usage | Sim | Sim | Sim | Sim | Sim |
GET /account/keys | Sim | Sim | Sim | Sim | Sim |
O streaming requer o add-on de WebSocket ($99/mês para Hobby e Pro, $149/mês para Sharp). O Enterprise inclui streaming sem custo adicional.
Requisições sem chave de APILink permanente para esta seção
Todo endpoint de dados exige uma chave de API, inclusive as listas de referência (/sports, /leagues, /sportsbooks, /markets). Para elas, uma chave gratuita basta. Uma requisição sem chave recebe 401 com o código missing_api_key.
Dois endpoints respondem sem chave:
GET /api/v1/health- Verificação de saúdeGET /api/v1/deeplink/{id}- Redirecionamento para uma casa de apostas; sem chave, há um limite de requisições
Códigos de ErroLink permanente para esta seção
Códigos relacionados à autenticação que você verá com mais frequência. Para a lista completa de 19 códigos HTTP mais os 6 códigos de frame WebSocket, consulte Visão Geral da API → Códigos de Erro.
| Código | Status HTTP | Descrição |
|---|---|---|
missing_api_key | 401 | Nenhuma chave de API foi fornecida |
invalid_api_key | 401 | A chave de API foi fornecida mas não é reconhecida |
expired_api_key | 401 | A chave de API expirou |
disabled_api_key | 401 | A chave de API está desabilitada, geralmente porque a assinatura expirou |
unauthorized | 401 | Falha na autenticação por bearer token em endpoints de administração ou monitoramento (distinto de invalid_api_key) |
invalid_token | 401 | Falha na verificação do token de sessão do dashboard Clerk |
tier_restricted | 403 | Endpoint ou recurso não disponível no seu plano |
rate_limited | 429 | Muitas requisições — veja retry_after |
too_many_streams | 429 | Número máximo de conexões SSE / WebSocket simultâneas atingido |
validation_error | 400 | Parâmetros de requisição malformados (substitui os obsoletos bad_request / invalid_request) |
upstream_error | 502 | Problema temporário ao acessar o upstream |
internal_error | 500 | Erro inesperado do servidor |
Formato de Resposta de ErroLink permanente para esta seção
Todos os erros seguem um formato consistente:
{
"error": {
"code": "invalid_api_key",
"message": "Invalid API key",
"docs": "https://docs.sharpapi.io/en/authentication"
}
}Boas PráticasLink permanente para esta seção
- Armazene as chaves de forma segura - Use variáveis de ambiente, nunca faça commit no controle de versão
- Use requisições server-side - Nunca exponha chaves em JavaScript client-side
- Implemente lógica de retry - Trate erros
429com backoff exponencial - Monitore o uso - Verifique o endpoint
/account/usagepara acompanhar o consumo - Rotacione chaves regularmente - Use o endpoint
/account/keys/:keyId/rotateperiodicamente para segurança