Título: Alerta de Engenharia: Lidando com Mudanças Quebradas nas APIs do Etherscan (Julho de 2026)

Por anos, o Etherscan tem sido a espinha dorsal do indexamento de dados do Ethereum. No entanto, uma mudança significativa está chegando. A partir de 1º de julho de 2026, o Etherscan está implementando mudanças que quebram suas restrições da API do Nível Gratuito.
Se seu dApp, indexador ou ferramenta de análise depende do Etherscan, você precisa refatorar sua lógica de busca de dados agora para evitar interrupções no serviço.
1. A Crise de Paginação: Limite de 10 mil para 1 mil registros
A atualização mais crítica é a redução do máximo de registros retornados por solicitação. O limite está caindo de 10.000 para 1.000 registros para usuários do nível gratuito.
Impacto Técnico:
Solicitações padrão de endereços de alta velocidade (como carteiras quentes de CEX ou protocolos DeFi populares) agora retornarão conjuntos de dados incompletos se seu deslocamento (offset) estava anteriormente definido para qualquer valor acima de 1.000.
Pontos de extremidade afetados:
Módulo de Conta: txlist, txlistinternal, tokentx, tokennfttx, token1155tx.
Logs e Outros: getLogs, getWithdrawals e Listas de Detentores de Tokens.
Ação Necessária: Implementar Paginação Agressiva
Você deve refatorar seus loops de busca.
2. Migração de Endpoints: Transações Internas por Faixa de Blocos para Nível Pro
O endpoint Obter Transações Internas por Faixa de Blocos será movido para um paywall do Plano Pro.
Impacto Técnico:
Solicitações a esse endpoint usando uma chave API do Nível Gratuito retornarão um erro 403 Forbidden ou um erro específico de limite de nível a partir de julho de 2026.
Estratégias de Mitigação:
Upgrade de Nível: A solução mais direta para aplicações de nível empresarial.
Consultas Granulares: Em vez de consultar por faixa de blocos, pode ser necessário buscar transações internas por hash de transação específico (txhash), embora isso aumente significativamente o número de chamadas à API e possa acionar limites de taxa.
3. Gerenciamento de Limites de Taxa (Throttling)
O Nível Gratuito ainda mantém um limite de 5 solicitações por segundo (RPS). Como agora você precisa de 10 solicitações para obter os dados que antes obtinha em uma, você tem 10x mais chances de atingir erros 429 Too Many Requests.
Recomendação:
Implementar um Backoff Exponencial ou um gerenciador de fila de solicitações (como p-throttle ou bottleneck) para garantir que sua nova lógica de busca em várias páginas não quebre sua chave API.
Checklist de Desenvolvimento para Migração:
Auditoria: Procure no seu código por chamadas à API do Etherscan onde o offset > 1000.
Refatoração: Implementar paginação recursiva ou baseada em loop usando o parâmetro page.
.
Tags: #Ethereum #Blockchain #API