Limites da API de odds por plano
Resposta: o REST usa um token bucket por chave; as conexões WebSocket contam por conta. Ao passar do limite você recebe 429 com um código claro.
| Plano | REST | Cota diária | WebSocket |
|---|---|---|---|
| Free | 1 req/s | 1.000 (zera às 00:00 UTC) | Não |
| Hobby | 2 req/s | Sem cota diária | Não |
| Builder | 10 req/s | Sem cota diária | 3 conexões |
| Pro | 30 req/s | Sem cota diária | 10 conexões |
O que o 429 retorna#
| Código | Causa | O que fazer |
|---|---|---|
rate_limited | Requisições demais por segundo | Espere os segundos do header Retry-After (também retryAfterMs no corpo) |
daily_quota | O Free usou as 1.000 requisições | Espere até 00:00 UTC ou faça upgrade |
connection_limit | WebSockets abertos demais | Feche um ou passe para o Pro |
Dicas práticas#
- Para painéis ao vivo use o WebSocket do Builder: sem polling.
- Consulte
GET /v1/accountpara ver seus limites eusage.restRequestsToday. - Cada chamada de ferramenta MCP conta como uma requisição REST.
- Detalhes: limites.
Builder (€99/mês) para WebSocket e histórico de fechamento. Teste de 3 dias; é preciso cartão, cobrado após o dia 3 se você não cancelar. REST grátis: cadastro.
Conteúdo educativo para maiores de 18 anos.
Perguntas frequentes#
As mensagens do WebSocket têm limite como o REST?#
O limite é no número de conexões; o volume de mensagens depende dos seus filtros. Clientes lentos recebem 4008 slow_consumer.
O limite é por chave ou por conta?#
O limite REST por segundo é por chave; conexões WebSocket e esportes escolhidos são por conta.
O MCP conta como REST?#
Sim: cada chamada de ferramenta é uma requisição REST.