Skip to main content

Giới hạn tốc độ là gì?

Giới hạn tốc độ kiểm soát số lượng yêu cầu bạn có thể gửi mỗi giây. Khi vượt quá giới hạn tốc độ, bạn sẽ nhận được phản hồi HTTP 429. Để biết cách xử lý khi gặp lỗi 429 hoặc lỗi tạm thời khác, hãy xem phần Thử lại và xử lý lỗi bên dưới.

Giới hạn tốc độ tiêu chuẩn

Gói của bạn có hai nhóm giới hạn tốc độ tiêu chuẩn: một nhóm dành cho các yêu cầu RPC và một nhóm dành cho các yêu cầu DAS API. Sau đây là giới hạn tốc độ cơ bản của từng gói Helius:
GóiGiới hạn tốc độ RPCDAS và API nâng cao
Miễn phí10 yêu cầu/giây2 yêu cầu/giây
Nhà phát triển50 yêu cầu/giây10 yêu cầu/giây
Doanh nghiệp200 yêu cầu/giây50 yêu cầu/giây
Chuyên nghiệp500 yêu cầu/giây100 yêu cầu/giây
EnterpriseTùy chỉnhTùy chỉnh

Tăng giới hạn tốc độ

Các nhóm sử dụng gói Chuyên nghiệp có thể mua thêm 100 RPS với giá $100/tháng. Nếu cần giới hạn tốc độ tùy chỉnh trước khi ra mắt, hãy liên hệ với đội ngũ bán hàng của chúng tôi. Nếu đang sử dụng gói Nhà phát triển hoặc Doanh nghiệp, vui lòng nâng cấp gói để tăng giới hạn tốc độ.

Giới hạn tốc độ đặc biệt

Một số điểm cuối và sản phẩm chuyên biệt của Helius có giới hạn tốc độ riêng do yêu cầu tính toán của chúng.

Gửi giao dịch

Điểm cuốiMiễn phíNhà phát triểnDoanh nghiệpChuyên nghiệp
Sender50/giây50/giây50/giây50/giây
sendTransaction1/giây5/giây50/giây100/giây
sendBundle——5/giây5/giây
simulateBundle10/giây50/giây200/giây500/giây
Nếu đang sử dụng gói Chuyên nghiệp và cần tăng giới hạn tốc độ sendTransaction, hãy liên hệ với đội ngũ bán hàng của chúng tôi. Người dùng gói Chuyên nghiệp cũng có thể yêu cầu tăng giới hạn tốc độ và thiết lập tiền tip tùy chỉnh cho Sender nhằm hỗ trợ các ứng dụng giao dịch có thông lượng cao hơn.

Lệnh gọi RPC phức tạp

Điểm cuốiMiễn phíNhà phát triểnDoanh nghiệpChuyên nghiệp
getProgramAccounts5/giây25/giây50/giây75/giây

Dữ liệu lịch sử

Khi gửi yêu cầu theo lô cho các phương thức dữ liệu lịch sử, các giới hạn sau sẽ được áp dụng:
Phương thứcKích thước lô tối đa
getTransaction100 mục cho mỗi yêu cầu
getTransactionsForAddressKhông cho phép yêu cầu theo lô
getTransfersByAddressKhông cho phép yêu cầu theo lô
Tất cả các phương thức dữ liệu lịch sử khác10 mục cho mỗi yêu cầu
Việc vượt quá giới hạn lô sẽ dẫn đến phản hồi lỗi. Đối với getTransactionsForAddress và getTransfersByAddress, mỗi địa chỉ phải được truy vấn trong một yêu cầu riêng.

LaserStream

Tài nguyênMiễn phíNhà phát triểnDoanh nghiệpChuyên nghiệp
Mạng—DevnetDevnet, MainnetDevnet, Mainnet
Số khóa công khai tối đa—10M10M10M
Kết nối đang hoạt động——10100

Wallet API

Wallet API áp dụng cùng giới hạn tốc độ với DAS và API nâng cao. Tất cả các điểm cuối đều dùng chung các giới hạn này:
Điểm cuốiMiễn phíNhà phát triểnDoanh nghiệpChuyên nghiệp
Tất cả điểm cuối Wallet API2/giây10/giây50/giây100/giây
Các điểm cuối này bao gồm tra cứu danh tính, số dư, lịch sử, chuyển khoản và nguồn nạp tiền. Tìm hiểu thêm trong tài liệu Wallet API của chúng tôi.

Luồng đã phân tích cú pháp

Tài nguyênMiễn phíNhà phát triểnDoanh nghiệpChuyên nghiệp
Kết nối đồng thời5105050
Đăng ký trên mỗi kết nối25252525
Các kết nối được tính theo từng dự án, trên tất cả khóa API của dự án đó. Dự án đạt giới hạn kết nối sẽ nhận được HTTP 429. Xem giới hạn Luồng đã phân tích cú pháp để biết giới hạn theo từng bộ lọc và tin nhắn.

LaserStream WebSocket

Tài nguyênMiễn phíNhà phát triểnDoanh nghiệpChuyên nghiệp
Kết nối đồng thời51502501,000
Đăng ký trên mỗi kết nối1,0001,0001,0001,000
Loại WebSocketTiêu chuẩnTiêu chuẩn, Nâng caoTiêu chuẩn, Nâng caoTiêu chuẩn, Nâng cao

Webhook

Tài nguyênMiễn phíNhà phát triểnDoanh nghiệpChuyên nghiệp
Số webhook tối đa5505050
Số địa chỉ trên mỗi webhook100k100k100k100k

Nén ZK

Dịch vụMiễn phíNhà phát triểnDoanh nghiệpChuyên nghiệp
Photon API2/giây10/giây50/giây100/giây
getValidityProof1/giây5/giây10/giây20/giây

Thử lại và xử lý lỗi

Khi ứng dụng nhận được phản hồi 429 Too Many Requests, 503 Service Unavailable hoặc phản hồi 5xx tạm thời, hãy chờ một lúc rồi thử lại — đừng thử lại ngay lập tức. Việc thử lại ngay sẽ khiến các yêu cầu dồn lại và làm quá trình phục hồi sau khi vượt giới hạn tốc độ chậm hơn, chứ không nhanh hơn.

Chiến lược đề xuất

  • Chờ khoảng 1 giây trước lần thử lại đầu tiên.
  • Tăng gấp đôi thời gian chờ sau mỗi lần thử lại, tối đa 30 giây.
  • Thêm một khoảng biến thiên ngẫu nhiên nhỏ ±25% vào mỗi lần chờ để nhiều ứng dụng không thử lại cùng một thời điểm.
  • Dừng sau 5 lần thử và trả lỗi về mã đã gọi bạn.

Những lỗi nên thử lại

Ví dụ

Cấu trúc phản hồi lỗi

Tất cả Helius API đều trả về nội dung JSON có cấu trúc khi xảy ra lỗi. Các điểm cuối JSON-RPC (Solana RPC, DAS, Sender, Priority Fee, ZK Compression) trả về cấu trúc bao JSON-RPC 2.0 tiêu chuẩn:
Các điểm cuối REST (Wallet API, Admin API) trả về:
Xem Các mã lỗi thường gặp để biết danh sách đầy đủ các mã lỗi và ý nghĩa của từng mã.