Limite de requisições

Os limites são por janela deslizante de 1 hora — cada requisição conta contra o limite pelos 60 minutos seguintes, não há um "zerar" em horário fixo — e separados em três faixas: leitura (GET), escrita (POST, PUT, PATCH, DELETE) e as ações que movimentam dinheiro, que têm um balde próprio, mais restrito.

Tipo	Limite
Leitura (GET)	60 requisições/hora
Escrita (POST, PUT, PATCH, DELETE)	1000 requisições/hora
Movimentação de dinheiro (emitir/cancelar cobrança, enviar/cancelar pagamento ao banco)	60 requisições/hora

As ações de movimentação de dinheiro contam apenas contra a faixa própria (throttle_v1_money), não contra a de escrita. Caso sua operação precise de um número maior, fale com o suporte ou comercial.

Headers de resposta

A cada requisição, o servidor anexa aos cabeçalhos da resposta os limites utilizados e quando a contagem libera:

Header	Exemplo	Descrição
X-RateLimit-Limit	60	Limite de requisições para o cliente.
X-RateLimit-Name	throttle_v1_write	Nome do throttle utilizado.
X-RateLimit-Remaining	0	Número de requisições disponíveis.
X-RateLimit-Reset	1782648000000	Unix time em milissegundos — quando a contagem reinicia.
Retry-After	30	Segundos até a contagem reiniciar. Ver Retry-After.

Exemplo de resposta em sucesso

Date: Fri, 17 Jul 2026 12:00:00 GMT
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 486

Exemplo de resposta em bloqueio

Quando o limite é atingido, o servidor retorna HTTP 429 Too Many Requests. Aguarde o número de segundos do header Retry-After antes da próxima requisição.

HTTP/1.1 429 Too Many Requests
Date: Fri, 17 Jul 2026 12:00:00 GMT
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1784293200000
X-RateLimit-Name: throttle_v1_write
Retry-After: 3600

{ "error": { "code": "RATE_LIMITED", "message": "Write request rate limit exceeded for this token." } }

dica

Use limit=100 nas listagens e os filtros para reduzir o número de requisições — e trate 429 com backoff pelo Retry-After, nunca com retry imediato.

Referência: RateLimit header fields for HTTP