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:
| Paket | Batas Laju RPC | DAS & API yang Disempurnakan |
|---|
| Gratis | 10 permintaan/dtk | 2 permintaan/dtk |
| Pengembang | 50 permintaan/dtk | 10 permintaan/dtk |
| Bisnis | 200 permintaan/dtk | 50 permintaan/dtk |
| Profesional | 500 permintaan/dtk | 100 permintaan/dtk |
| Perusahaan | Kustom | Kustom |
Meningkatkan Batas Laju
Tim dengan paket Profesional dapat membeli tambahan 100 RPS seharga $100/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
| Endpoint | Gratis | Pengembang | Bisnis | Profesional |
|---|
Sender | 50/dtk | 50/dtk | 50/dtk | 50/dtk |
sendTransaction | 1/dtk | 5/dtk | 50/dtk | 100/dtk |
sendBundle | — | — | 5/dtk | 5/dtk |
simulateBundle | 10/dtk | 50/dtk | 200/dtk | 500/dtk |
Jika Anda menggunakan paket Profesional dan perlu meningkatkan batas laju sendTransaction, hubungi tim penjualan kami.
Pengguna paket Profesional juga dapat meminta peningkatan batas laju dan pengaturan tip khusus untuk Sender guna mendukung aplikasi perdagangan dengan throughput yang lebih tinggi.
Panggilan RPC Kompleks
| Endpoint | Gratis | Pengembang | Bisnis | Profesional |
|---|
getProgramAccounts | 5/dtk | 25/dtk | 50/dtk | 75/dtk |
Data Historis
Saat membuat permintaan batch untuk metode data historis, batas berikut berlaku:
| Metode | Ukuran Batch Maksimum |
|---|
getTransaction | 100 item per permintaan |
getTransactionsForAddress | Permintaan batch tidak diizinkan |
getTransfersByAddress | Permintaan batch tidak diizinkan |
| Semua metode historis lainnya | 10 item per permintaan |
Melebihi batas batch akan menghasilkan respons kesalahan. Untuk getTransactionsForAddress dan getTransfersByAddress, setiap alamat harus dikueri dalam permintaan terpisah.
LaserStream
| Sumber Daya | Gratis | Pengembang | Bisnis | Profesional |
|---|
| Jaringan | — | Devnet | Devnet, Mainnet | Devnet, Mainnet |
| Pubkey Maksimum | — | 10M | 10M | 10M |
| Koneksi Aktif | — | — | 10 | 100 |
Wallet API
Wallet API mengikuti batas laju yang sama dengan DAS & API yang Disempurnakan. Semua endpoint berbagi batas berikut:
| Endpoint | Gratis | Pengembang | Bisnis | Profesional |
|---|
| Semua Endpoint Wallet API | 2/dtk | 10/dtk | 50/dtk | 100/dtk |
Ini mencakup pencarian identitas, saldo, riwayat, transfer, dan endpoint sumber pendanaan. Pelajari selengkapnya dalam dokumentasi Wallet API kami.
Stream yang Diuraikan
| Sumber Daya | Gratis | Pengembang | Bisnis | Profesional |
|---|
| Koneksi Bersamaan | 5 | 10 | 50 | 50 |
| Langganan per Koneksi | 25 | 25 | 25 | 25 |
Koneksi dihitung per proyek di seluruh API key miliknya. Proyek yang mencapai batas koneksi akan menerima HTTP 429. Lihat batas Parsed Streams untuk batas per filter dan pesan.
WebSocket LaserStream
| Sumber Daya | Gratis | Pengembang | Bisnis | Profesional |
|---|
| Koneksi Bersamaan | 5 | 150 | 250 | 1,000 |
| Langganan per Koneksi | 1,000 | 1,000 | 1,000 | 1,000 |
| Jenis WebSocket | Standar | Standar, Disempurnakan | Standar, Disempurnakan | Standar, Disempurnakan |
Webhook
| Sumber Daya | Gratis | Pengembang | Bisnis | Profesional |
|---|
| Webhook Maksimum | 5 | 50 | 50 | 50 |
| Alamat per Webhook | 100k | 100k | 100k | 100k |
Kompresi ZK
| Layanan | Gratis | Pengembang | Bisnis | Profesional |
|---|
| Photon APIs | 2/dtk | 10/dtk | 50/dtk | 100/dtk |
getValidityProof | 1/dtk | 5/dtk | 10/dtk | 20/dtk |
Percobaan ulang dan penanganan kesalahan
Saat aplikasi Anda menerima respons 429 Too Many Requests, 503 Service Unavailable, atau 5xx sementara, tunggu sebentar lalu coba lagi — jangan langsung mencoba lagi. Percobaan ulang seketika akan menumpuk permintaan dan memperlambat pemulihan batas laju, bukan mempercepatnya.
Strategi yang disarankan
- Tunggu sekitar 1 detik sebelum percobaan ulang pertama.
- Gandakan waktu tunggu setiap kali Anda mencoba lagi, hingga maksimum 30 detik.
- Tambahkan sedikit variasi acak 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
Semua Helius API mengembalikan isi JSON terstruktur saat terjadi kesalahan. Endpoint JSON-RPC (Solana RPC, DAS, Sender, Priority Fee, ZK Compression) mengembalikan pembungkus standar JSON-RPC 2.0:
Endpoint REST (Wallet API, Admin API) mengembalikan:
Lihat Kode kesalahan umum untuk daftar lengkap kode kesalahan dan arti masing-masing.