Tiêu đề: Cảnh báo Kỹ thuật: Xử lý Thay đổi Phá vỡ trong API Etherscan (Tháng 7 năm 2026)

Trong nhiều năm, Etherscan đã là xương sống của việc lập chỉ mục dữ liệu Ethereum. Tuy nhiên, một sự thay đổi lớn sắp xảy ra. Có hiệu lực từ ngày 1 tháng 7 năm 2026, Etherscan sẽ thực hiện các thay đổi phá vỡ giới hạn API Miễn phí của mình.
Nếu dApp, bộ lập chỉ mục hoặc công cụ phân tích của bạn dựa vào Etherscan, bạn cần chỉnh sửa lại logic lấy dữ liệu của mình ngay bây giờ để tránh gián đoạn dịch vụ.
1. Áp lực phân trang: Giới hạn ghi nhận từ 10k xuống 1k
Cập nhật quan trọng nhất là giảm giới hạn tối đa các bản ghi trả về mỗi yêu cầu. Giới hạn này sẽ giảm từ 10.000 xuống 1.000 bản ghi cho người dùng miễn phí.
Ảnh hưởng kỹ thuật:
Các yêu cầu fetch tiêu chuẩn cho các địa chỉ tốc độ cao (như ví nóng CEX hoặc các giao thức DeFi phổ biến) bây giờ sẽ trả về dữ liệu không đầy đủ nếu offset của bạn trước đó đã đặt trên 1.000.
Các điểm cuối bị ảnh hưởng:
Mô-đun Tài khoản: txlist, txlistinternal, tokentx, tokennfttx, token1155tx.
Nhật ký & Các mục khác: getLogs, getWithdrawals, và Danh sách Người giữ Token.
Hành động cần thiết: Thực hiện phân trang Mạnh mẽ
Bạn phải chỉnh sửa vòng lặp fetch của mình.
2. Chuyển đổi điểm cuối: Phạm vi khối Giao dịch nội bộ sang Gói Pro
Điểm cuối Lấy Giao dịch nội bộ theo phạm vi khối sẽ chuyển sang sau hàng trả phí Gói Pro.
Ảnh hưởng kỹ thuật:
Các yêu cầu tới điểm cuối này bằng khóa API Miễn phí sẽ trả về lỗi 403 Forbidden hoặc lỗi giới hạn gói cụ thể bắt đầu từ tháng 7 năm 2026.
Chiến lược giảm thiểu:
Nâng cấp Gói: Giải pháp đơn giản nhất cho các ứng dụng doanh nghiệp.
Truy vấn Chi tiết: Thay vì truy vấn theo phạm vi khối, bạn có thể cần lấy các giao dịch nội bộ theo Hash Giao dịch cụ thể (txhash), mặc dù điều này làm tăng số lượng cuộc gọi API đáng kể và có thể kích hoạt giới hạn tốc độ.
3. Quản lý Giới hạn Tốc độ (Giảm tốc)
Gói Miễn phí vẫn duy trì giới hạn 5 yêu cầu mỗi giây (RPS). Vì bây giờ bạn cần 10 yêu cầu để lấy dữ liệu như trước, khả năng gặp lỗi 429 Too Many Requests cao hơn gấp 10 lần.
Khuyến nghị:
Thực hiện Backoff theo cấp số nhân hoặc quản lý hàng đợi yêu cầu (như p-throttle hoặc bottleneck) để đảm bảo logic lấy dữ liệu nhiều trang mới của bạn không làm sập khóa API của bạn.
Danh sách kiểm tra dành cho nhà phát triển khi chuyển đổi:
Kiểm tra: Tìm trong mã của bạn bất kỳ cuộc gọi API Etherscan nào có offset > 1000.
Chỉnh sửa: Thực hiện phân trang đệ quy hoặc dựa trên vòng lặp sử dụng tham số trang.
.
Thẻ: #Ethereum #Blockchain #API