Pengaturan API WEEX 2026: Izin Key, Ikat IP, Batas Rate

API key WEEX dibuat lewat versi web, maksimal 10 per akun. Key baru hanya bisa membaca (read-only); untuk menempatkan order Anda harus mencentang izin trading Futures atau Spot, dan dokumen resmi sama sekali tidak mencantumkan izin penarikan. IP bisa diikat saat membuat key. Passphrase hanya boleh huruf dan angka, dan tidak bisa dipulihkan kalau hilang. Key baru atau yang diubah butuh sekitar 15 menit sebelum aktif di seluruh sistem. Batas penempatan order futures adalah 300 kali per menit per akun, dan domain simulasi api-sim.weex.com bisa dipakai untuk uji coba (dokumen API resmi WEEX, dicek 2026-10-17).

Panduan ini mengikuti dokumen API V3 WEEX dan endpoint publik resminya: cara membuat key, memilih izin, tanda tangan dan timestamp, batas rate per jenis endpoint, kontrak mana yang bisa diperdagangkan lewat API, lingkungan simulasi, serta isi ketentuan resmi soal biaya dan rebate untuk order API. Daftar WEEX dengan kode otter123 dan biaya futures di-rebate 70% (60% rebate otomatis dari bursa + 10% rebate tambahan), 3,5 kali kode umum 20%, jadi sebagian biaya dari setiap transaksi strategi Anda kembali.

Poin utama

• Dibuat di web: lewat halaman manajemen API, maksimal 10 key per pengguna. Simpan tiga hal: APIKey, SecretKey, dan passphrase yang Anda tentukan.
• Izin: default read-only. Centang Futures untuk strategi futures dan Spot untuk spot. Keduanya terpisah; tanpa izin yang tepat Anda mendapat -1052 (izin tidak cukup).
• Ikat IP: opsional saat membuat key. WEEX menyebut key tanpa ikatan IP berisiko dan sangat menyarankan whitelist.
• Batas rate: penempatan order dihitung per akun, 300 per menit untuk futures dan 100 per 10 detik untuk spot. Endpoint lain memakai bobot IP. Melewati batas menghasilkan HTTP 429, dan terus mengirim permintaan berujung blokir 10 detik.
• Tidak semua kontrak bisa lewat API: daftar API WEEX mencakup 298 dari 1.040 kontrak, termasuk BTCUSDT, ETHUSDT, dan SOLUSDT.
• Rebate: mengikat rebate cukup dengan UID, tidak perlu API key.

Cara membuat key

Dari dokumen API futures WEEX Preparation (dicek 2026-10-17):

1. Masuk ke WEEX versi web, buka halaman manajemen API (weex.com/account/newapi), lalu buat key baru.
2. Tentukan passphrase. FAQ menyarankan hanya huruf dan angka, tanpa karakter khusus.
3. Pilih izin. Key baru read-only; centang Futures atau Spot hanya jika perlu trading.
4. Ikat alamat IP bila diinginkan.
5. Simpan APIKey, SecretKey, dan passphrase. Passphrase yang hilang tidak bisa dipulihkan atau diubah; key harus dihapus dan dibuat ulang.

FAQ menyatakan bahwa key yang baru dibuat atau diubah biasanya butuh sekitar 15 menit untuk aktif di seluruh sistem, jadi kalau key baru gagal autentikasi, tunggu dulu sebelum mencari masalah. Daftar kode error lama WEEX juga memuat 40016: akun harus sudah mengikat nomor ponsel atau Google Authenticator (kode error API WEEX). Halaman itu dari 2025 dan untuk API versi lama; dokumen V3 tidak menyebut apakah aturan ini masih berlaku, jadi aktifkan 2FA lebih dulu.

Jika akun memicu kontrol risiko (login mencurigakan, banyak permintaan tidak valid), akses API bisa dimatikan otomatis dan Anda perlu meminta support untuk mengaktifkannya kembali. WEEX menyarankan endpoint V3; V1 dan V2 sedang dihentikan.

Izin: mana yang diaktifkan

Dari FAQ API futures dan FAQ API spot resmi (diperbarui 2026-04-14):

Untuk pengguna biasa hanya izin itu yang ada di dokumen, dan tidak ada izin penarikan. API sub-akun broker memang punya izin deposit dan penarikan, tetapi itu integrasi terpisah untuk broker, bukan untuk menjalankan strategi sendiri.

Copy trading juga punya API sendiri: hanya trader yang bisa membuatnya, satu akun trader mendapat 1 key, dan dana serta posisi copy trading terpisah sepenuhnya dari futures biasa. API ini tidak mendukung spot (FAQ API copy trading). Cara kerja lead trading ada di copy trading WEEX.

Tanda tangan, timestamp, dan domain

Dari halaman resmi Signature dan General Information:

• Domain: produksi futures https://api-contract.weex.com, simulasi futures https://api-sim.weex.com, spot https://api-spot.weex.com.
• Header: endpoint privat butuh ACCESS-KEY, ACCESS-SIGN, ACCESS-TIMESTAMP, dan ACCESS-PASSPHRASE, dengan Content-Type: application/json.
• Tanda tangan: gabungkan timestamp + metode huruf besar + path + (jika ada query string) "?" dan query string + body, tandatangani dengan HMAC SHA256 memakai SecretKey, lalu encode Base64.
• Timestamp: milidetik. Permintaan yang selisihnya lebih dari 30 detik dari waktu server ditolak, jadi jaga jam server tetap sinkron atau ambil waktu server dulu.

Contoh minimal memanggil endpoint saldo di simulasi futures (GET /capi/v3/account/balance, bobot IP 5). Key dibaca dari environment variable, bukan ditulis di kode:

import base64, hashlib, hmac, os, time, requests

KEY = os.environ["WEEX_API_KEY"]          # read-only is enough for this call
SECRET = os.environ["WEEX_API_SECRET"]
PASSPHRASE = os.environ["WEEX_API_PASSPHRASE"]
HOST = "https://api-sim.weex.com"        # simulation; live: https://api-contract.weex.com
path, query, body = "/capi/v3/account/balance", "", ""

ts = str(int(time.time() * 1000))
message = ts + "GET" + path + ("?" + query if query else "") + body
sign = base64.b64encode(
    hmac.new(SECRET.encode(), message.encode(), hashlib.sha256).digest()
).decode()

r = requests.get(HOST + path, headers={
    "ACCESS-KEY": KEY, "ACCESS-SIGN": sign, "ACCESS-TIMESTAMP": ts,
    "ACCESS-PASSPHRASE": PASSPHRASE, "Content-Type": "application/json",
})
print(r.status_code, r.headers.get("X-USED-WEIGHT-1M"), r.text[:200])

WEEX menyebut semua endpoint REST futures berjalan di simulasi dengan path, parameter, dan tanda tangan yang sama; cukup ganti domain. Dokumen tidak menyebut apakah simulasi butuh key terpisah, jadi uji sendiri. Dokumen spot tidak mencantumkan domain simulasi.

Batas rate per jenis endpoint

Menurut Access Restrictions, semua endpoint selain penempatan order dibatasi menurut bobot IP, terlepas dari key atau UID. Penempatan order dibatasi per akun (userId) dan tidak memakai bobot IP. Angka di bawah dari dua FAQ API dan endpoint publik exchangeInfo, dicek 2026-10-17:

Jendela bobot IP futures tidak sama di dua sumber: FAQ menyebut per 10 detik, sedangkan exchangeInfo mengembalikan interval: MINUTE, intervalNum: 10. WEEX menunjuk exchangeInfo sebagai sumber batas, jadi untuk aman rencanakan 500 bobot per 10 menit. Setiap respons membawa header X-USED-WEIGHT-* dan X-REMAINING-WEIGHT-* (bobot IP) serta X-ORDER-COUNT-* dan X-ORDER-REMAINING-* (order), sehingga kode Anda bisa memperlambat diri. Halaman pasang order futures juga menyebut setiap order dihitung ke batas 10 detik dan 1 menit; angka batas 10 detiknya tidak dipublikasikan.

Begitu menerima 429, berhenti: WEEX menyebut terus mengirim permintaan memicu blokir 10 detik.

Kontrak mana yang bisa lewat API

Trading API punya daftar simbol sendiri. Pada 2026-10-17, exchangeInfo mencantumkan 1.040 kontrak (564 perpetual kripto dan 476 perpetual saham serta aset tradisional lain), sedangkan /capi/v3/market/apiTradingSymbols mencantumkan 298. Daftar API spot berisi 535 pasangan. Order API pada simbol di luar daftar menghasilkan -1052. Panggil endpoint itu sebelum live, jangan berasumsi yang bisa diperdagangkan di situs juga bisa lewat API.

Batas lain di dokumen: simbol peka huruf besar-kecil dan harus huruf besar; koneksi WebSocket wajib mengirim header User-Agent atau firewall mengembalikan 403; TradingView dan FIX API tidak didukung.

Biaya dan rebate untuk order API

Biaya: exchangeInfo publik menunjukkan perpetual BTCUSDT dengan maker 0,02% dan taker 0,08%, dan 913 dari 1.040 kontrak memakai tarif itu. Tarif aktual akun Anda bisa dicek lewat GET /capi/v3/account/commissionRate. Order futures mendukung POST_ONLY, yang hanya mengantre di order book; biaya maker seperempat biaya taker. Untuk level VIP lihat level VIP WEEX. Perlu dicatat, VIP8 mensyaratkan minimal 450 juta USDT dari 500 juta volume futures berasal dari non-API, jadi akun yang dominan API tidak bisa mencapai level tertinggi.

Rebate: pasal 5.1 Ketentuan Program Afiliasi WEEX (diperbarui 2026-01-08) menyebut komisi dihitung dari biaya trading yang benar-benar dibayar referral yang memenuhi syarat, setelah dikurangi diskon biaya yang WEEX berikan ke kelompok pelanggan tertentu dan "Biaya Lain", yang bisa mencakup biaya akibat penggunaan alat trading pihak ketiga. Ketentuan itu tidak mengecualikan order API dan juga tidak menjamin order API selalu dihitung, jadi cek rincian rebate Anda untuk volume API atau bot pihak ketiga.

Satu program lagi yang perlu dibedakan: program market maker WEEX mensyaratkan UID pemohon tidak punya afiliasi komisi apa pun. Akun yang terdaftar di bawah kode referral tidak memenuhi syarat; jika ingin tarif market maker, Anda perlu akun terpisah dan mengajukan lewat email ke WEEX.

Contoh hitungan: 3 juta USDT, taker vs maker

Misalkan strategi futures bertransaksi 3 juta USDT per bulan, dengan tarif daftar VIP0 dan rebate futures Fee Otter 70%:

Dengan volume yang sama, semua taker tanpa rebate memakan 2.400 USDT; order maker ditambah rebate 70% hanya 180 USDT. Soal batas rate, 300 order per menit rata-rata 5 per detik, lebih dari yang dipakai strategi grid atau tren biasa. Strategi yang sering membatalkan dan memasang ulang order perlu ingat bahwa pembatalan memakai bobot IP, bukan batas order.

Ini estimasi dari tarif daftar; yang berlaku adalah riwayat transaksi dan rincian rebate Anda. Bagian 60% dikembalikan WEEX langsung ke akun bursa Anda dan 10% diselesaikan harian oleh Fee Otter; lihat tangkapan layar di halaman rasio rebate. Rebate hanya berlaku untuk biaya trading, bukan funding atau likuidasi. Langkah pendaftaran ada di cara daftar WEEX; jika sudah terdaftar dengan kode orang lain, lihat panduan ganti ikatan WEEX. Hitungan lintas bursa ada di rebate biaya untuk trader kuantitatif.

Jika Anda sudah VIP di sebuah bursa atau bertransaksi besar dengan bot dan ingin pindah atau membuka bursa lain, hubungi support Fee Otter. Kami bekerja dengan tim resmi bursa untuk mengajukan keuntungan trading khusus atau rasio rebate lebih tinggi; hasil akhirnya ditentukan bursa.

Keamanan: satu key untuk satu tugas

Jangan pernah memberikan API key, SecretKey, atau passphrase kepada siapa pun yang menawarkan pengelolaan akun atau menjanjikan untung pasti. Dokumen WEEX menyebut ketiganya langsung menentukan keamanan akun; bocornya salah satu bisa membuat aset hilang, dan key yang bocor harus segera dihapus.

• Key terpisah: satu untuk strategi sendiri, satu untuk bot pihak ketiga, satu untuk alat pembukuan, masing-masing hanya dengan izin yang diperlukan. Sepuluh key sudah cukup.
• Ikat IP bila bisa: jika strategi berjalan di server cloud dengan IP tetap, ikat alamat keluarnya. Sebagian alat pihak ketiga tidak punya IP keluar tetap dan tidak bisa terhubung jika ada whitelist; beri mereka key read-only.
• Jauhkan key dari version control: pakai environment variable atau secrets manager, jangan di kode, tangkapan layar, atau grup chat.
• Periksa rutin: cek halaman API untuk key yang tidak Anda kenal, dan hapus key layanan yang sudah tidak dipakai.

Wilayah layanan

Ketentuan Penggunaan WEEX (diperbarui 2026-02-19, dicek 2026-10-17) mengecualikan Kanada, Amerika Serikat dan wilayahnya, Tiongkok daratan, Hong Kong, Singapura, Uni Emirat Arab, Korea Utara, Kuba, Iran, Suriah, Sudan, wilayah Ukraina yang dikuasai Rusia, Somalia, Myanmar, dan Venezuela, dan WEEX bisa menambah daftar kapan saja. Indonesia tidak ada di daftar tersebut. Penduduk wilayah yang dikecualikan tidak bisa membuka akun WEEX. Status lisensi per negara ada di lisensi bursa kripto per negara.

Risiko

Otomasi memperbesar kesalahan. Satu parameter keliru atau koneksi putus yang tidak ditangani bisa memicu rentetan order salah dalam hitungan menit, dan dengan leverage futures kerugiannya bisa melebihi perkiraan. Jalankan siklus pasang order, batal, dan sambung ulang secara penuh di simulasi dulu, lalu mulai live dengan ukuran kecil. Bursa juga mengubah daftar simbol API dan batasnya, jadi kode Anda harus menangani error seperti -1052 dan 429, bukan mencoba ulang terus-menerus.

Pertanyaan umum

Di mana membuat API key WEEX?

Masuk ke versi web dan buka halaman manajemen API (weex.com/account/newapi). Setiap pengguna bisa memiliki hingga 10 key.

Bisakah API key WEEX menarik dana?

Dokumen hanya memberi pengguna biasa izin read-only, trading futures, dan trading spot. Tidak ada izin penarikan.

Saya lupa passphrase. Bagaimana?

Passphrase tidak bisa dipulihkan atau diubah. Hapus key dan buat yang baru.

Kenapa order saya menghasilkan -1052?

Biasanya satu dari tiga hal: izin Futures atau Spot belum dicentang, simbol tidak ada di daftar trading API, atau Anda masih memakai endpoint V1/V2.

Berapa batas order API futures WEEX?

300 order per menit per akun. Endpoint lain memakai bobot IP; melewati batas menghasilkan 429, dan terus mengirim memicu blokir 10 detik.

Apakah saya perlu memberi API key ke Fee Otter untuk rebate?

Tidak. Pengikatan cukup dengan UID, tanpa API key, kata sandi, atau izin trading apa pun.

Bacaan lanjutan

• Panduan rebate biaya WEEX
• Panduan futures WEEX
• Level VIP WEEX
• Perbandingan API bursa kripto
• Pengaturan API trading Bybit

Izin, tanda tangan, batas rate, dan aturan simulasi diambil dari dokumen API V3 WEEX, FAQ API (diperbarui 2026-04-14), dan API publik WEEX; rincian rebate dan wilayah dari Ketentuan Program Afiliasi dan Ketentuan Penggunaan WEEX, semuanya dicek 2026-10-17. WEEX mengubah daftar simbol API, batas, dan aturannya, dan dokumen resmi terkini yang berlaku. Kode hanya contoh; uji sendiri sebelum trading live. Rasio rebate ditetapkan bursa dan platform dan dapat berubah. Ini hanya informasi, bukan saran investasi.

Data diverifikasi: 2026-10-17

ⓘ Rasio rebate Fee Otter di artikel ini untuk futures; spot: WEEX 45%.