Menghubungkan Bot Trading ke WEEX API: Checklist Risiko 12 Poin

Menghubungkan bot trading ke WEEX API merupakan keputusan tentang izin, batas laju permintaan, dan penanganan kegagalan, dan sebagian besar kerugian bot dapat ditelusuri ke salah satu dari tiga hal yang dilewati. Checklist di bawah mencakup dua belas hal yang perlu dipastikan sebelum bot menempatkan order live pertamanya: bagaimana cakupan dan pengikatan kunci API, bagaimana bot menghadapi batas bobot per IP dan batas order per akun WEEX, apa yang terjadi saat jam mengalami drift atau koneksi terputus, cara menghentikannya, serta apakah bot masih menggunakan versi API yang tersedia setelah 30 September. Setiap poin menjelaskan apa yang harus diperiksa, mengapa hal tersebut khususnya penting di WEEX, dan seperti apa kondisi selesai. Jalankan seluruh daftar pada akun demo terlebih dahulu; endpoint simulasi API futures membuatnya mudah.

Pemeriksaan kunci dan izin (1–4)

1. Kunci memiliki cakupan yang tepat sesuai kebutuhan bot. Kunci WEEX secara default menggunakan Read Only dan dapat diberi cakupan trading Spot atau Futures/Contract. Bot grid spot mendapat Spot; bot perpetual mendapat Futures/Contract; tidak ada yang mendapat keduanya. WEEX tidak memiliki cakupan penarikan, sehingga skenario terburuk dapat dihilangkan, tetapi kunci trading pada pasar yang salah tetap dapat menyebabkan kerugian atas dana yang tidak ingin Anda buka. Selesai: daftar izin kunci menampilkan satu cakupan trading.

2. Kunci terikat pada IP bot. Untuk bot yang di-host sendiri, ikat kunci ke alamat statis VPS. Untuk platform bot ter-host, ikat ke alamat IP yang dipublikasikan platform untuk lalu lintas keluar; jika platform tidak dapat memberikan daftar yang stabil, itu alasan untuk mempertimbangkan ulang platform tersebut, bukan alasan membiarkan kunci terbuka. Dokumentasi WEEX menjelaskan kunci yang tidak terikat sebagai risiko keamanan. Selesai: panggilan uji dari IP lain ditolak.

3. Kunci dikhususkan untuk bot ini. Gunakan satu kunci per bot dan per mesin, dari 10 grup yang diizinkan WEEX. Saat terjadi masalah, Anda ingin mencabut satu bot tanpa menghentikan bot lain dan memiliki riwayat order yang menunjukkan bot mana melakukan apa. Selesai: nama kunci mengidentifikasi bot dan host.

4. Secret dan passphrase disimpan di penyimpanan secret. Bukan di source code bot, tangkapan layar, atau chat dukungan platform. Passphrase tidak dapat dipulihkan, jadi simpan bersama SecretKey. Selesai: clone baru repositori bot tidak berisi kredensial.

Pemeriksaan batas laju dan jam (5–7)

5. Bot membaca header batas laju WEEX. Sebagian besar endpoint REST dibatasi per IP berdasarkan bobot; penempatan order dibatasi per akun dalam bucket ORDERS. Melebihi salah satunya mengembalikan HTTP 429 dan larangan selama 10 detik. Respons membawa X-USED-WEIGHT dan X-REMAINING-WEIGHT untuk endpoint berbobot serta X-ORDER-COUNT dan X-ORDER-REMAINING untuk endpoint order, dalam interval detik, menit, jam, dan hari. Bot yang mengurangi kecepatan saat anggaran tersisa rendah tidak terkena larangan; bot yang mencoba ulang setelah 429 justru memperpanjangnya. Selesai: log menunjukkan bot melakukan throttling sebelum 429, dan 429 memicu jeda, bukan loop retry.

6. Beberapa bot dalam satu IP berbagi satu anggaran. Karena batas bobot berlaku per IP, tiga bot di VPS yang sama bersaing untuk alokasi yang sama, sementara masing-masing hanya memiliki anggaran order per akun sendiri jika berjalan dengan akun berbeda. Selesai: Anda telah menjumlahkan laju polling setiap proses pada host dan hasilnya berada dalam anggaran IP dengan ruang cadangan.

7. Jam host tersinkronisasi. WEEX menolak permintaan yang timestamp-nya berjarak lebih dari 30 detik dari waktu server. Clock drift menghasilkan kegagalan autentikasi yang muncul sesekali seperti masalah kunci dan, lebih buruk lagi, dapat membuat bot tidak mampu membatalkan order yang sudah ditempatkan. Selesai: NTP berjalan, dan bot mengambil waktu server saat startup serta setelah penolakan timestamp.

Pemeriksaan penanganan order dan kegagalan (8–10)

8. Order bersifat idempoten. Setiap permintaan order membawa newClientOrderId yang dibuat secara deterministik dari sinyal, sehingga retry setelah timeout tidak dapat menyebabkan pengisian ganda. WEEX menerima client ID sepanjang 1 hingga 36 karakter dari kumpulan karakter terbatas. Selesai: menghentikan bot di tengah permintaan lalu memulai ulang tidak menghasilkan order duplikat.

9. Bot melakukan rekonsiliasi dengan exchange, bukan memorinya sendiri. Setelah reconnect atau restart, bot meminta posisi dan order terbuka dari WEEX dan menganggapnya sebagai kebenaran. Bot yang mempercayai ledger internal setelah crash dapat melakukan hedge terhadap posisi yang sudah tidak ada atau meninggalkan posisi terbuka yang dianggapnya sudah tertutup. Selesai: restart paksa saat posisi terbuka menghasilkan status yang benar dalam satu siklus polling.

10. Ada kill switch yang benar-benar sudah diuji. Dua lapisan. Di dalam bot: ukuran posisi maksimum, kerugian harian maksimum, dan laju order maksimum; masing-masing menghentikan trading dan membatalkan order terbuka saat terlampaui. Di luar bot: Anda tahu bahwa menghapus kunci API pada halaman API Management WEEX akan langsung menghentikannya, dan Anda sudah melakukannya sekali di demo untuk melihat perilaku bot saat kuncinya mati. Selesai: kedua lapisan sengaja dipicu dan bot berhenti dengan bersih.

Pemeriksaan platform dan siklus hidup (11–12)

11. Bot menggunakan versi API terbaru. Dokumentasi API futures WEEX menandai V2 akan dihentikan pada 30 September, dengan V3 sebagai versi saat ini. Platform ter-host atau konektor open source lama yang masih menargetkan endpoint V2 akan berhenti berfungsi, mungkin saat posisi masih terbuka. Selesai: setiap endpoint yang dipanggil bot merupakan path V3, atau platform telah mengonfirmasi secara tertulis bahwa konektor WEEX-nya adalah V3.

12. Seluruh daftar telah lulus di demo. API futures WEEX menyediakan endpoint simulasi, termasuk POST /capi/v3/sim/order dan GET /capi/v3/sim/balance, yang menggunakan autentikasi dan penandatanganan yang sama seperti live serta diselesaikan dalam SUSDT demo. Jalankan bot cukup lama untuk melihat restart, peringatan batas laju, pemicu stop-loss, dan pencabutan kunci. Selesai: bot telah menyelesaikan setidaknya satu minggu penuh di demo dengan log error yang bersih, dan perpindahan ke live hanya berupa perubahan konfigurasi dari /sim/ ke path live serta penggantian kunci yang ditinjau manusia.

Platform ter-host atau dibuat sendiri: perbedaan risikonya

Checklist ini berlaku untuk keduanya, tetapi titik lemahnya berpindah.

Platform bot ter-host mengambil alih pekerjaan teknis (pembatasan laju, rekonsiliasi, dan migrasi versi), lalu menggantinya dengan risiko pihak lawan: kunci Anda disimpan di infrastruktur mereka, dan kebocoran di sana akan mengekspos semua kunci yang mereka pegang. Kurangi risiko dengan mengikat IP ke alamat yang mereka publikasikan, menggunakan cakupan minimum, dan melakukan rotasi saat berhenti memakai platform. Sebelum terhubung, tanyakan dua hal: apakah mereka memublikasikan IP keluar yang stabil, dan apakah konektor WEEX mereka sudah V3?

Bot buatan sendiri menghilangkan pihak lawan, tetapi memberi Anda semua pekerjaan teknis dalam daftar. Hal yang sering dilewati adalah 7, 8, 9, dan 10 karena hanya penting saat terjadi kegagalan, sementara akun demo adalah tempat kegagalan tersebut tidak mahal. Alokasikan lebih banyak waktu untuk kill switch daripada strategi.

Hal yang diperhatikan operator berpengalaman

Dua pola menjelaskan sebagian besar ledakan bot yang bukan kegagalan strategi. Pertama adalah loop retry diam-diam: gangguan jaringan, 429, exponential backoff yang tidak pernah diterapkan, dan bot yang terus menghantam endpoint order selama larangan 10 detik, sementara pembatalan stop-loss menunggu dalam antrean. Kedua adalah kunci usang: bot yang dihentikan beberapa bulan lalu tetapi kunci Futures/Contract-nya tidak pernah dihapus, masih valid, dan masih tidak terikat. Poin 5 mencegah yang pertama; poin 3 ditambah audit API Management setiap kuartal mencegah yang kedua. Tidak perlu kecerdikan, hanya pelaksanaan.

FAQ

1. Apakah aman menghubungkan bot trading ke WEEX API?

Keamanannya bergantung pada apakah kunci dibatasi untuk satu pasar, terikat IP, didedikasikan untuk bot, dan bot menangani batas laju, clock drift, idempotensi, serta rekonsiliasi. Kunci WEEX tidak dapat melakukan penarikan, sehingga hasil terburuk dapat dihilangkan, tetapi kerugian trading tetap mungkin terjadi.

2. Izin API apa yang dibutuhkan bot di WEEX?

Bot spot membutuhkan cakupan trading Spot; bot futures membutuhkan Futures/Contract. Bot yang hanya memantau membutuhkan Read Only. Jangan pernah mengaktifkan kedua cakupan trading pada satu kunci.

3. Apa yang terjadi jika bot saya melebihi batas laju WEEX?

API mengembalikan HTTP 429 dan memberlakukan larangan selama 10 detik. Endpoint order dibatasi per akun; sebagian besar endpoint lain dibatasi per IP berdasarkan bobot. Baca header X-USED-WEIGHT dan X-ORDER-COUNT agar tetap di bawah batas.

4. Bisakah saya menguji bot di WEEX tanpa uang sungguhan?

Ya. Endpoint simulasi API futures di bawah /capi/v3/sim/ menggunakan autentikasi live dan diselesaikan dalam dana demo, sementara terminal demo memungkinkan Anda melihat order bot secara real time.

5. Apa yang dimaksud dengan penghentian WEEX API V2?

Dokumentasi API WEEX mencantumkan V2 akan dihentikan pada 30 September, dengan V3 sebagai versi saat ini. Bot dan platform yang masih menargetkan endpoint V2 harus bermigrasi sebelum tanggal tersebut.

6. Bagaimana cara menghentikan bot segera?

Hapus kunci API-nya pada halaman API Management WEEX; bot langsung kehilangan akses. Kemudian batalkan order terbuka dan tinjau posisi secara manual. Bangun juga kill switch internal agar bot dapat berhenti sendiri saat mengalami kerugian atau pelanggaran ukuran.

Peringatan Risiko

Trading otomatis melalui API exchange menggabungkan risiko pasar dan risiko operasional. Posisi futures berleverage dapat dilikuidasi dengan cepat, dan bug bot, kegagalan jaringan, larangan akibat batas laju, clock drift, atau kunci API yang bocor dapat menempatkan order atau gagal membatalkannya dengan cara yang menyebabkan kerugian yang tidak akan dipilih manusia, dan tidak ada yang dapat dibatalkan. Platform bot pihak ketiga menambahkan risiko pihak lawan terhadap kredensial API Anda. Harga cryptocurrency volatil dan Anda dapat kehilangan sebagian atau seluruh modal yang dikendalikan bot. Perilaku, batas, dan jadwal versi WEEX API dijelaskan berdasarkan September 2026 dan dapat berubah; informasi ini bukan nasihat investasi.