Langsung ke konten utama

Apa itu batas laju?

Batas laju mengontrol jumlah permintaan yang dapat Anda buat per detik. Jika batas laju terlampaui, Anda akan menerima respons HTTP 429. Untuk panduan tentang tindakan yang perlu dilakukan saat menerima 429 atau kegagalan sementara lainnya, lihat Percobaan ulang dan penanganan kesalahan di bawah ini.

Batas Laju Standar

Paket Anda memiliki dua grup batas laju standar: satu untuk permintaan RPC dan satu untuk permintaan DAS API. Berikut adalah batas laju dasar untuk setiap paket Helius:
PaketBatas Laju RPCDAS & API yang Disempurnakan
Gratis10 permintaan/dtk2 permintaan/dtk
Pengembang50 permintaan/dtk10 permintaan/dtk
Bisnis200 permintaan/dtk50 permintaan/dtk
Profesional500 permintaan/dtk100 permintaan/dtk
PerusahaanKustomKustom

Tingkatkan Batas Laju

Tim dengan paket Professional dapat membeli tambahan 100 RPS seharga $100 USD/bulan. Jika Anda memerlukan batas laju khusus sebelum peluncuran, hubungi tim penjualan kami. Jika Anda menggunakan tingkat Pengembang atau Bisnis, tingkatkan paket Anda untuk menaikkan batas laju.

Batas Laju Khusus

Beberapa endpoint dan produk khusus Helius memiliki batas laju khusus karena kebutuhan komputasinya.

Mengirim Transaksi

EndpointGratisPengembangBisnisProfesional
Sender50/dtk50/dtk50/dtk50/dtk
sendTransaction1/dtk5/dtk50/dtk100/dtk
sendBundle——5/dtk5/dtk
simulateBundle10/dtk50/dtk200/dtk500/dtk
Permintaan tanpa kunci Sender /fast dibatasi hingga 1 permintaan per detik per IP keluar, per wilayah. Pemanggil di belakang NAT yang sama berbagi batas ini. Permintaan 429 yang ditolak diperhitungkan dalam batas tersebut; /ping tidak. Tambahkan kunci API proyek Helius Anda yang sudah ada untuk mendapatkan batas 50 permintaan per detik, per kunci, per wilayah.
Jika Anda menggunakan paket Professional dan perlu meningkatkan batas laju sendTransaction, hubungi tim penjualan kami. Pengguna paket Professional juga dapat meminta peningkatan batas laju dan pengaturan tip khusus untuk Sender guna mendukung aplikasi perdagangan dengan throughput lebih tinggi.

Panggilan RPC Kompleks

EndpointGratisDeveloperBusinessProfessional
getProgramAccounts5/detik25/detik50/detik75/detik

Data Historis

Saat membuat permintaan batch untuk metode data historis, batas berikut berlaku:
MetodeUkuran Batch Maksimum
getTransaction100 item per permintaan
getTransactionsForAddressPermintaan batch tidak diizinkan
getTransfersByAddressPermintaan batch tidak diizinkan
Semua metode historis lainnya10 item per permintaan
Melebihi batas batch akan menghasilkan respons kesalahan. Untuk getTransactionsForAddress dan getTransfersByAddress, setiap alamat harus dikueri dalam permintaan terpisah.

LaserStream

Sumber DayaGratisDeveloperBusinessProfessional
Jaringan—DevnetDevnet, MainnetDevnet, Mainnet
Pubkey Maksimum—10M10M10M
Koneksi Aktif——10100

Wallet API

Wallet API mengikuti batas laju yang sama dengan DAS & Enhanced API. Semua endpoint berbagi batas berikut:
EndpointGratisDeveloperBusinessProfessional
Semua Endpoint Wallet API2/detik10/detik50/detik100/detik
Ini mencakup pencarian identitas, saldo, riwayat, transfer, dan endpoint sumber pendanaan. Pelajari lebih lanjut dalam dokumentasi Wallet API kami.

Stream yang Diurai

Sumber DayaGratisDeveloperBusinessProfessional
Koneksi Bersamaan5105050
Langganan per Koneksi25252525
Koneksi dihitung per proyek di seluruh kunci API proyek tersebut. Proyek yang telah mencapai batas koneksinya akan menerima HTTP 429. Lihat batas Parsed Streams untuk batas per filter dan pesan.

WebSocket LaserStream

Sumber DayaGratisDeveloperBusinessProfessional
Koneksi Bersamaan51502501,000
Langganan per Koneksi1,0001,0001,0001,000
Jenis WebSocketStandarStandar, EnhancedStandar, EnhancedStandar, Enhanced

Webhook

Sumber DayaGratisDeveloperBusinessProfessional
Webhook Maksimum5505050
Alamat per Webhook100k100k100k100k

Kompresi ZK

LayananGratisDeveloperBusinessProfessional
Photon API2/detik10/detik50/detik100/detik
getValidityProof1/detik5/detik10/detik20/detik

Percobaan Ulang dan Penanganan Kesalahan

Saat aplikasi Anda menerima respons 429 Too Many Requests, 503 Service Unavailable, atau respons sementara 5xx, tunggu sejenak lalu coba lagi — jangan langsung mencoba lagi. Percobaan ulang langsung akan menumpuk permintaan dan memperlambat, bukan mempercepat, pemulihan batas laju.

Strategi yang Direkomendasikan

  • Tunggu sekitar 1 detik sebelum percobaan ulang pertama.
  • Gandakan waktu tunggu setiap kali Anda mencoba lagi, hingga maksimum 30 detik.
  • Tambahkan variasi acak kecil sebesar ±25% pada setiap waktu tunggu agar beberapa aplikasi tidak mencoba lagi pada saat yang sama.
  • Hentikan setelah 5 percobaan dan kembalikan kesalahan ke kode pemanggil.

Kesalahan yang Perlu Dicoba Ulang

Contoh

Struktur Respons Kesalahan

Semua API Helius mengembalikan isi JSON terstruktur saat terjadi kesalahan. Endpoint JSON-RPC (Solana RPC, DAS, Sender, Priority Fee, ZK Compression) mengembalikan envelope JSON-RPC 2.0 standar:
Endpoint REST (Wallet API, Admin API) mengembalikan:
Lihat Kode kesalahan umum untuk daftar lengkap kode kesalahan beserta arti masing-masing.