Заголовок: Інженерне попередження: обробка змін, що порушують роботу API Etherscan (липень 2026)

Протягом років Etherscan був основою індексування даних Ethereum. Однак настає значний зсув. З 1 липня 2026 року Etherscan вводить змінені обмеження для свого API безкоштовного рівня.
Якщо ваш dApp, індексатор або аналітичний інструмент залежить від Etherscan, вам потрібно зараз переписати логіку отримання даних, щоб уникнути збоїв у сервісі.
1. Проблема пагінації: обмеження 10 тис. до 1 тис. записів
Найважливіше оновлення — зменшення максимальної кількості записів, що повертаються за запитом. Обмеження знижується з 10 000 до 1 000 записів для користувачів безкоштовного рівня.
Технічний вплив:
Стандартні запити на отримання даних для адрес з високою швидкістю (наприклад, гарячі гаманці CEX або популярні DeFi-протоколи) тепер повертатимуть неповні набори даних, якщо ваш зсув раніше був встановлений вище 1 000.
Затронуті кінцеві точки:
Модуль облікового запису: txlist, txlistinternal, tokentx, tokennfttx, token1155tx.
Логи та інше: getLogs, getWithdrawals, списки власників токенів.
Необхідна дія: впровадити агресивну пагінацію
Вам потрібно переписати цикли отримання даних.
2. Міграція кінцевої точки: внутрішні транзакції за діапазоном блоків до тарифу Pro
Кінцева точка "Отримати внутрішні транзакції за діапазоном блоків" переходить за платною стратегією Pro.
Технічний вплив:
Запити до цієї кінцевої точки з використанням API-ключа безкоштовного рівня починаючи з липня 2026 року повертатимуть помилку 403 Forbidden або конкретну помилку обмеження рівня.
Стратегії пом’якшення:
Оновлення рівня: найпростіше рішення для корпоративних застосунків.
Гранульоване запитування: замість запиту за діапазоном блоків можливо потрібно отримувати внутрішні транзакції за конкретним хешем транзакції (txhash), хоча це значно збільшує кількість API-запитів і може викликати обмеження швидкості.
3. Управління обмеженнями швидкості (Throttling)
Безкоштовний рівень все ще має обмеження 5 запитів на секунду (RPS). Оскільки тепер потрібно 10 запитів, щоб отримати дані, які раніше отримувалися за один, ви в 10 разів більше ймовірності натрапити на помилку 429 Too Many Requests.
Рекомендація:
Впровадити експоненційне зворотне відставання або менеджер черги запитів (наприклад, p-throttle або bottleneck), щоб ваша нова логіка багатосторінкового отримання даних не зламала ваш API-ключ.
Перевірка для розробників при міграції:
Аудит: пошук у кодовій базі будь-яких викликів API Etherscan, де зсув > 1000.
Переписати: реалізувати рекурсивне або циклічне пагінування за допомогою параметра page.
.
Теги: #Ethereum #Blockchain #API