Título: Alerta de Engenharia: Gestão de Mudanças Significativas nas APIs do Etherscan (Julho de 2026)

Durante anos, o Etherscan tem sido a espinha dorsal do indexação de dados do Ethereum. No entanto, uma mudança significativa está a caminho. A partir de 1 de julho de 2026, o Etherscan implementará alterações disruptivas nas restrições da sua API de Nível Gratuito.
Se a sua dApp, indexador ou ferramenta de análise depende do Etherscan, precisa de refatorar a sua lógica de obtenção de dados agora para evitar interrupções no serviço.
1. A Pressão da Paginação: Limite de 10 mil para 1 mil Registos
A atualização mais crítica é a redução do número máximo de registos devolvidos por pedido. O limite vai passar de 10.000 para 1.000 registos para utilizadores do nível gratuito.
Impacto Técnico:
Pedidos padrão de endereços de alta velocidade (como carteiras quentes de CEX ou protocolos DeFi populares) agora devolverão conjuntos de dados incompletos se o seu offset estiver anteriormente definido para qualquer valor acima de 1.000.
Pontos finais afetados:
Módulo de Conta: txlist, txlistinternal, tokentx, tokennfttx, token1155tx.
Registos e Outros: getLogs, getWithdrawals, e Listas de Detentores de Tokens.
Ação Necessária: Implementar Paginação Agressiva
Deve refatorar os seus ciclos de obtenção de dados.
2. Migração de Endpoints: Faixa de Blocos para Transações Internas para Nível Pro
O endpoint Obter Transações Internas por Faixa de Blocos será movido para uma assinatura Pro.
Impacto Técnico:
Pedidos a este endpoint usando uma chave API de Nível Gratuito devolverã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:
Atualização 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 precisar de obter transações internas por Hash de Transação específico (txhash), embora isso aumente significativamente o número de chamadas à API e possa ativar limites de taxa.
3. Gestão de Limites de Taxa (Throttling)
O Nível Gratuito mantém um limite de 5 pedidos por segundo (RPS). Como agora precisa de 10 pedidos para obter os dados que anteriormente recebia em um, há uma probabilidade 10 vezes maior de atingir erros 429 Too Many Requests.
Recomendação:
Implementar um Backoff Exponencial ou um gestor de fila de pedidos (como p-throttle ou bottleneck) para garantir que a sua nova lógica de obtenção de múltiplas páginas não cause falhas na sua chave API.
Lista de Verificação para Migração por Desenvolvedor:
Auditar: Procurar no seu código chamadas à API do Etherscan onde o offset seja > 1000.
Refatorar: Implementar paginação recursiva ou baseada em ciclos usando o parâmetro page.
.
Tags: #Ethereum #Blockchain #API