Chuyển đến nội dung chính

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 Professional có thể mua thêm 100 RPS với giá 100 USD/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
Các yêu cầu Sender không cần khóa /fast bị giới hạn ở mức 1 yêu cầu mỗi giây cho mỗi IP đầu ra ở mỗi khu vực. Các bên gọi nằm sau cùng một NAT sẽ dùng chung giới hạn này. Các yêu cầu 429 bị từ chối vẫn được tính vào giới hạn; /ping thì không. Hãy thêm khóa API của dự án Helius hiện có để áp dụng giới hạn 50 yêu cầu mỗi giây cho mỗi khóa ở mỗi khu vực.
Nếu đang sử dụng gói Professional 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 Professional cũng có thể yêu cầu tăng giới hạn tốc độ và thiết lập tiền boa 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íDeveloperBusinessProfessional
getProgramAccounts5/giây25/giây50/giây75/giây

Dữ liệu lịch sử

Khi gửi yêu cầu hàng loạt 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 mỗi yêu cầu
getTransactionsForAddressKhông cho phép yêu cầu hàng loạt
getTransfersByAddressKhông cho phép yêu cầu hàng loạt
Tất cả các phương thức dữ liệu lịch sử khác10 mục mỗi yêu cầu
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íDeveloperBusinessProfessional
Mạng—DevnetDevnet, MainnetDevnet, Mainnet
Số Pubkey 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à Enhanced APIs. Tất cả các điểm cuối dùng chung các giới hạn này:
Điểm cuốiMiễn phíDeveloperBusinessProfessional
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 cấp vố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

Tài nguyênMiễn phíDeveloperBusinessProfessional
Kết nối đồng thời5105050
Đăng ký trên mỗi kết nối25252525
Số 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 HTTP 429. Xem giới hạn của Luồng đã phân tích để biết giới hạn theo từng bộ lọc và giới hạn tin nhắn.

LaserStream WebSocket

Tài nguyênMiễn phíDeveloperBusinessProfessional
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íDeveloperBusinessProfessional
Số webhook tối đa5505050
Số địa chỉ trên mỗi webhook100k100k100k100k

Nén ZK

Dịch vụMiễn phíDeveloperBusinessProfessional
Photon APIs2/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 lập tức khiến các yêu cầu dồn lại và làm chậm quá trình khôi phục sau khi chạm giới hạn tốc độ thay vì đẩy nhanh quá trình này.

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 cùng thử lại vào 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ả API của Helius đều trả về phần thân 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 phổ biến để biết danh sách đầy đủ các mã lỗi và ý nghĩa của từng mã.