Batas Laju API WEEX: Bobot Permintaan dan Error 429

By: WEEX
|
0

Batas Laju API WEEX: Bobot Permintaan dan Error 429

Batas API WEEX bergantung pada jenis permintaan. API REST menggunakan bobot permintaan berbasis IP dan kuota order berbasis akun, sedangkan koneksi dan langganan WebSocket memiliki batasnya sendiri. Untuk mengetahui kuota yang berlaku bagi integrasi Anda, periksa exchangeInfo produk, bobot endpoint, dan header respons. Jika Anda menerima HTTP 429, jeda permintaan yang terdampak sebelum menyesuaikan lajunya.

Sebuah bot dapat mencapai batas meskipun lalu lintasnya sendiri terlihat rendah. Layanan data pasar, skrip pemantauan, dan strategi lain mungkin menggunakan IP keluar yang sama. Memahami kuota bersama tersebut lebih berguna daripada menetapkan batas permintaan per detik tersendiri untuk setiap proses.

Apa perbedaan antara jumlah permintaan, bobot, dan batas order?

batas akses Spot dan batas akses futures menjelaskan dua kuota REST:

Jenis permintaanKuota berdasarkanDampak praktis
Data pasar, kueri akun, dan endpoint lain selain penempatan orderBobot permintaan untuk IP keluarAplikasi yang menggunakan IP yang sama perlu mengoordinasikan lalu lintasnya.
Penempatan orderKuota ORDERS dan userId akunPanggilan menggunakan kuota order yang didokumentasikan. Permintaan penempatan ini tidak menggunakan bobot IP.

Bobot bukan sekadar jumlah panggilan. Kueri dengan bobot 10 menggunakan 10 unit bobot, dan bobot beberapa endpoint berubah sesuai parameter permintaan. Karena itu, dua puluh panggilan dapat menggunakan jumlah bobot yang berbeda, bergantung pada endpoint yang digunakan.

Penempatan order tunggal dan batch Spot menggunakan kuota order. Pembatalan dan kueri order tetap menggunakan batas IP. Mengganti kunci API tidak memberikan anggaran IP baru kepada aplikasi yang sama.

Di mana saya dapat memeriksa kuota saat ini?

Spot dan futures memiliki endpoint informasi exchange yang terpisah:

ProdukAlamat kueri
SpotGET https://api-spot.weex.com/api/v3/exchangeInfo
FuturesGET https://api-contract.weex.com/capi/v3/market/exchangeInfo

Temukan rateLimits dalam respons dan baca keempat bidangnya secara bersamaan. rateLimitType mengidentifikasi kuota, interval dan intervalNum menentukan jendela waktu, sedangkan limit menunjukkan kuota dalam jendela tersebut.

Sebagai contoh, respons Spot yang diperiksa pada 04/11/2026 menunjukkan REQUEST_WEIGHT sebesar 500 per 10 detik dan ORDERS sebesar 100 per 10 detik. Angka pertama menunjukkan unit bobot; angka kedua adalah kuota order. Nilai-nilai ini menggambarkan cuplikan konfigurasi Spot tersebut. Jangan menyalinnya untuk futures atau menganggapnya sebagai konstanta permanen dalam aplikasi Anda.

Gunakan endpoint futures untuk mengetahui batas futures. Jika responsnya berbeda dari FAQ atau referensi endpoint, simpan respons dan waktu kueri agar dukungan API dapat mengonfirmasi aturan sebelum Anda mengubah lalu lintas produksi.

Gunakan header respons untuk melacak penggunaan saat aplikasi berjalan

Respons IP melaporkan X-USED-WEIGHT-(intervalNum)(intervalLetter) dan X-REMAINING-WEIGHT-(intervalNum)(intervalLetter) untuk bobot yang telah digunakan dan yang tersisa. Sebagai contoh, X-USED-WEIGHT-1M menunjukkan bobot yang telah digunakan oleh IP saat ini dalam jendela satu menit.

Penempatan order menggunakan X-ORDER-COUNT-(intervalNum)(intervalLetter) dan X-ORDER-REMAINING-(intervalNum)(intervalLetter). Catat nama interval yang benar-benar dikembalikan agar Anda dapat mengetahui batas mana yang mulai didekati aplikasi.

Jika beberapa layanan menggunakan IP atau akun yang sama, pertimbangkan untuk mengelola kuotanya secara terpusat. Sisakan kapasitas untuk kueri order, pembatalan, dan pemulihan agar operasi tersebut tetap memiliki ruang saat lalu lintas data pasar meningkat.

Bagaimana cara memulihkan layanan dari HTTP 429?

Jeda antrean permintaan yang mencapai batas, lalu periksa header respons dan jendela waktunya. Setelah itu, tingkatkan jeda percobaan ulang secara bertahap dan gunakan variasi acak (jitter) agar pekerja tidak melanjutkan secara bersamaan dan langsung mencapai batas yang sama. Tentukan jeda sesuai jendela yang berlaku, alih-alih mengandalkan satu nilai tetap untuk setiap permintaan.

Selanjutnya, telusuri lalu lintasnya. Periksa polling duplikat, kueri data lengkap yang tidak diperlukan, atau bot yang menggunakan IP bersama tetapi melacak kuotanya secara terpisah. Memperlambat satu proses mungkin tidak mengurangi lalu lintas gabungan.

Dokumen batas akses resmi menyatakan bahwa pelampauan batas akan menghasilkan 429, dan pelanggaran berulang akan mengakibatkan pemblokiran selama 10 detik. Durasi pemblokiran tersebut bukan jaminan bahwa akses akan pulih setelah menunggu tepat 10 detik. Jika permintaan order juga mengalami timeout atau hasilnya tidak jelas, periksa statusnya sebelum mengirim ulang agar tidak terjadi duplikasi.

Batas WebSocket mana yang terpisah?

Dokumentasi WebSocket Spot dan futures mencantumkan 300 permintaan koneksi per IP setiap lima menit, hingga 20 koneksi serentak per IP, 240 operasi langganan per koneksi per jam, dan hingga 100 kanal per koneksi.

Angka-angka tersebut mengukur aktivitas koneksi atau langganan. Artinya bukan server hanya dapat mengirim 240 pembaruan pasar atau order per jam. Menggunakan kembali koneksi, memelihara daftar langganan, dan menangani heartbeat dapat mengurangi upaya koneksi dan langganan yang tidak perlu. Terapkan backoff saat menyambungkan kembali setelah terjadi kegagalan.

Kuota ini tetap penting saat menggunakan CCXT atau SDK, terutama pada beberapa aplikasi yang berbagi IP atau akun. Jika batas yang Anda amati berbeda dari perkiraan, gunakan tautan dukungan di FAQ API resmi. Sertakan endpoint, stempel waktu, kode status, dan header respons yang telah disanitasi untuk membantu mendiagnosis masalah.

Artikel terkait
Bagikan
copy

Gainer

iconiconiconiconiconiconiconicon
Dukungan Pelanggan:@weikecs
Kerja Sama Bisnis:@weikecs
Trading Kuantitatif & MM:bd@weex.com
Program VIP:support@weex.com