Limites de requisições e planos

Dois tipos de limite

Todo plano tem uma cota mensal, o número de requisições cobradas por mês do calendário, e um limite por minuto que protege a API contra picos de tráfego. As cotas são renovadas às 00:00 UTC do dia 1º de cada mês.

Os planos também diferem no intervalo de atualização, ou seja, no quão recentes são os preços. Consultar com mais frequência do que o seu intervalo retorna os mesmos preços e apenas consome a cota.

Visão geral dos planos

• Free: 100 requisições/mês, atualizações diárias, 10 requisições/minuto
• Lite: 1.000 requisições/mês, atualizações a cada 30 minutos, 30 requisições/minuto
• Standard: 10.000 requisições/mês, atualizações a cada 10 minutos, 60 requisições/minuto
• Advanced: 50.000 requisições/mês, atualizações a cada 60 segundos, 120 requisições/minuto
• Pro: 100.000 requisições/mês, atualizações a cada 60 segundos, 300 requisições/minuto
• Ultra: 500.000 requisições/mês, atualizações a cada 15 segundos, 600 requisições/minuto
• Business: 500.000 requisições/mês, atualizações a cada 15 segundos, 600 requisições/minuto, além de um SLA de disponibilidade
• Enterprise: 1.500.000 requisições/mês, atualizações a cada 5 segundos, 1.200 requisições/minuto

Os recursos também crescem com o plano. Os preços por quilate exigem um plano pago, os preços bid/ask começam no Standard, os alertas por webhook no Advanced e o stream em tempo real no Pro. Veja os valores atuais em preços.

O que conta como requisição

• Cada chamada bem-sucedida a um endpoint de dados conta como uma requisição, não importa quantos símbolos ela retorne.
• /symbols e /usage são gratuitos e nunca contam.
• Requisições rejeitadas com 104 (limite por minuto), 106 (fora do seu plano), 107 (origem não permitida) ou com um erro de servidor (500, 503) não são cobradas.
• Requisições que falham por causa da própria consulta contam. Isso inclui os erros de validação de 201 a 210 e o 300 (sem resultados), então valide datas e símbolos antes de enviá-los.

Acompanhando o seu uso

Toda resposta autenticada informa a sua cota nos cabeçalhos:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9876
X-RateLimit-Used: 124
X-RateLimit-Reset: 1793491200
X-RateLimit-Reset-Date: 2026-11-01T00:00:00.000Z
X-RateLimit-Plan: Standard
X-RateLimit-Minute-Limit: 60
X-RateLimit-Minute-Remaining: 59

Os mesmos números estão no objeto rate_limit do corpo JSON. reset é um timestamp Unix e reset_date é o mesmo momento em ISO 8601: o início do próximo mês em UTC.

Consultando o uso sem gastar cota

Chame /usage a partir de painéis ou do seu monitoramento. É gratuito:

{
  "success": true,
  "usage": {
    "requests_made": 124,
    "requests_quota": 10000,
    "requests_remaining": 9876,
    "plan": "standard",
    "period_start": "2026-10-01T00:00:00.000Z",
    "period_end": "2026-11-01T00:00:00.000Z"
  },
  "result": { "plan": "Standard", "used": 124, "total": 10000, "remaining": 9876 },
  "rate_limit": {
    "limit": 10000,
    "remaining": 9876,
    "reset": 1793491200,
    "used": 124,
    "plan": "Standard",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

Quando você atinge um limite

Os dois limites respondem com o status HTTP 429 e um corpo de erro:

• 104 too_many_requests: requisições demais no minuto atual. A resposta inclui um cabeçalho Retry-After com o número de segundos a aguardar. Diminua o ritmo e tente novamente.
• 105 quota_exceeded: a cota mensal foi esgotada. As requisições continuam falhando até que a cota seja renovada no dia 1º (UTC). Fazer upgrade do plano tem efeito imediato.

{
  "success": false,
  "error": {
    "code": 105,
    "type": "quota_exceeded",
    "info": "User has reached or exceeded his subscription plan's monthly API request allowance"
  }
}

Mantendo-se dentro da cota

• Mantenha as respostas em cache por, no mínimo, o intervalo de atualização do seu plano.
• Solicite todos os símbolos de que você precisa em uma única chamada, em vez de uma chamada por símbolo.
• Consultar a cada 10 minutos usa cerca de 4.500 requisições por mês. Consultar a cada minuto usa cerca de 45.000. Escolha o plano que corresponde à sua frequência de consulta.
• A partir do plano Pro, use o stream em tempo real em vez de polling, e use alertas de preço para reagir a limiares.

Mais dicas em Boas práticas.