API key BingX dibuat di halaman API Management, lewat web atau aplikasi, dan Anda mendapat dua informasi: API key dan secret key. BingX menyarankan memasang IP whitelist dan menghapus lalu membuat ulang key segera jika bocor. Izinnya mencakup spot trading, read, perpetual futures trading, universal transfer, dan transfer internal sub-akun; spot dan futures USDT-M memakai key yang sama dengan izin yang diatur terpisah. Setiap akun utama bisa memiliki hingga 20 key, timestamp permintaan harus dalam 5 detik dari waktu server, dan endpoint market dibatasi 500 permintaan per 10 detik per IP (dokumentasi API resmi BingX, dicek 2026-10-17).
Panduan ini disusun dari dokumentasi API dan FAQ API resmi BingX: membuat key dan izin, IP whitelist, tanda tangan dan timestamp, rate limit dan kontrol risiko, uji coba demo, serta biaya dan rebate untuk order API. Daftar BingX dengan kode FEEOTTER dan 45% biaya Anda kembali (seluruhnya rebate otomatis dari BingX), tanpa mengikat UID dan tanpa menyerahkan API key ke Fee Otter.
Ringkasan
- Di mana: halaman API Management di situs atau aplikasi BingX; FAQ BingX menegaskan aplikasi mendukung pengelolaan API key.
- Izin: spot trading, read, perpetual futures trading, universal transfer, transfer internal sub-akun; dokumentasi API juga mencantumkan izin penarikan untuk key sub-akun.
- Jumlah: hingga 20 key dan 20 sub-akun per akun utama, serta 20 key per sub-akun.
- Tanda tangan: HMAC SHA256 dengan header X-BX-APIKEY; timestamp tidak boleh berbeda lebih dari 5 detik dari waktu server.
- Rate limit: per UID, per endpoint, ditambah batas IP 500 permintaan per 10 detik untuk endpoint market; pembatasan pulih setelah sekitar 5 menit.
- Demo: domain demo futures adalah open-api-vst.bingx.com, memakai USDT virtual (VST).
Membuat key
Bagian "Generate an API Key" di dokumentasi BingX singkat saja: buat key di halaman API Management, catat API key dan secret key yang diberikan dan jangan pernah membagikannya, pasang IP whitelist saat mengaturnya, dan jika key bocor, hapus segera lalu buat yang baru.
- Masuk ke BingX, buka halaman API Management di akun Anda, lalu buat API key.
- Beri label, centang izin yang diperlukan, dan isi IP whitelist jika memungkinkan.
- Selesaikan verifikasi keamanan, lalu salin API key dan secret key ke tempat yang aman.
Kami tidak menemukan artikel bantuan BingX langkah demi langkah tentang apa yang harus disiapkan lebih dulu (KYC, autentikasi dua faktor) atau apakah secret hanya ditampilkan sekali, jadi ikuti petunjuk di halaman pembuatan. Sumber: dokumentasi API BingX, FAQ API BingX (diperbarui 2026-10-14).
Izin: mana yang perlu diaktifkan
| Izin | Fungsinya | Saran |
|---|---|---|
| Read | Melihat saldo, posisi, dan order | Satu-satunya yang dibutuhkan alat pembukuan dan pajak |
| Spot trading | Memasang dan membatalkan order spot | Hanya untuk strategi spot |
| Perpetual futures trading | Memasang dan membatalkan order perpetual USDT-M, mengatur leverage | Diperlukan untuk strategi futures |
| Universal transfer | Memindahkan dana antara akun spot, futures, dan lainnya | Hanya jika strategi harus memindahkan dana sendiri |
| Transfer internal sub-akun | Mengizinkan transfer internal antar-sub-akun | Hanya saat akun utama mengelola sub-akun |
Kode izin tercantum di endpoint "create sub-account API key" dalam dokumentasi API: 1 spot trading, 2 read, 3 perpetual futures trading, 4 universal transfer, 7 izinkan transfer internal sub-akun; changelog dokumentasi menambahkan 5, penarikan, untuk key sub-akun. FAQ BingX juga menjelaskan bahwa futures USDT-M dan spot memakai API key yang sama tetapi izin trading keduanya diatur terpisah. Key untuk bot atau alat copy trading pihak ketiga cukup diberi izin trading: tanpa penarikan dan tanpa universal transfer.
IP whitelist
Dokumentasi BingX menyarankan memasang IP whitelist saat membuat key; permintaan dari IP yang tidak ada di daftar akan mendapat error 100419, "IP does not match IP whitelist". Kami tidak menemukan di dokumentasi resmi maupun Pusat Bantuan berapa IP yang bisa dipasang per key, apakah rentang IP diperbolehkan, atau apakah key tanpa IP kedaluwarsa, jadi ikuti halaman pembuatan. Server BingX berada di AWS Singapura (ap-southeast-1), sehingga strategi yang peka latensi bisa dijalankan di dekatnya.
Tanda tangan, timestamp, dan domain
- Tanda tangan: tandatangani parameter permintaan dengan secret key memakai HMAC SHA256 dan kirim hasilnya sebagai parameter signature. Parameter di query string digabung sesuai urutan aslinya tanpa diurutkan; parameter di request body harus diurutkan a sampai z lebih dulu.
- Header: kirim X-BX-APIKEY: API key Anda.
- Timestamp: dalam milidetik, dan harus berada dalam 5 detik dari waktu server API, jika tidak permintaan dianggap kedaluwarsa dan ditolak. Jika jam Anda bergeser, sinkronkan dengan /openApi/swap/v2/server/time lebih dulu.
- Domain: trading live di open-api.bingx.com, demo futures di open-api-vst.bingx.com.
Contoh minimal untuk melihat saldo akun perpetual USDT (Python, hanya ilustrasi):
import time, hmac, hashlib, requests
API_KEY = "API key Anda"
SECRET = "secret key Anda"
HOST = "https://open-api.bingx.com" # demo: https://open-api-vst.bingx.com
path = "/openApi/swap/v3/user/balance"
params = f"timestamp={int(time.time() * 1000)}"
sign = hmac.new(SECRET.encode(), params.encode(), hashlib.sha256).hexdigest()
r = requests.get(f"{HOST}{path}?{params}&signature={sign}",
headers={"X-BX-APIKEY": API_KEY})
print(r.json())Jangan menulis key dan secret langsung di kode; gunakan variabel lingkungan untuk pemakaian sungguhan.
Rate limit dan kontrol risiko
Dari bagian "Rate limit" dokumentasi API dan FAQ API:
- Limit per UID: setiap endpoint punya limit sendiri yang independen, dicantumkan di dokumentasi endpoint itu. Header respons X-RateLimit-Requests-Remain (sisa permintaan) dan X-RateLimit-Requests-Expire (berakhirnya jendela waktu) bisa dipakai untuk menyesuaikan laju permintaan.
- Limit IP: endpoint market mengizinkan 500 permintaan per 10 detik. Sejak 2025-12-16, limit IP pada grup API akun 2 dan 3 (2.000 permintaan per 10 detik per grup, 300 per endpoint) tidak berlaku lagi.
- Saat terkena limit: permintaan berlebihan dibatasi otomatis dan pulih setelah sekitar 5 menit; terus mengirim setelah 429 bisa membuat IP diblokir otomatis (418); 403 berarti aturan firewall terpicu, biasanya diblokir 5 menit, lebih lama atau permanen jika lalu lintasnya dianggap berbahaya.
- Order yang sama: order yang sama hanya bisa dikirim sekali per detik, dan endpoint pembatalan menerima orderId yang sama sekali per detik.
Dari FAQ API BingX: perilaku trading yang sangat berbeda dari pengguna biasa bisa dilarang trading untuk jangka waktu yang tidak pasti. Sering menempati harga bid dan ask terbaik, sering memasang dan membatalkan order tanpa eksekusi, tingkat eksekusi atau bobot trading yang sangat rendah, serta terus mengirim permintaan setelah menerima 429 akan memperpanjang larangan itu. (FAQ-08 API BingX)
Dokumentasi yang kami baca tidak mencantumkan batas per UID untuk endpoint order futures di bagian ini, jadi andalkan header sisa permintaan.
Uji coba di demo dulu
Dokumentasi API BingX menyebut open-api-vst.bingx.com sebagai domain order demo futures, dengan margin dan PnL dalam VST (USDT virtual). Saat VST menipis, Anda bisa memanggil /openApi/swap/v2/trade/getVst (ditingkatkan ke v2 pada 2025-12-18, mendukung penambahan dan pengurangan jumlah sesuai keinginan). Ada juga endpoint /openApi/swap/v2/trade/order/test yang menerima dan mengembalikan kolom yang sama dengan order sungguhan tetapi tidak memasang order dan tidak memotong dana, berguna untuk mengecek tanda tangan dan parameter. Aturan demo di web dan aplikasi ada di peluncuran demo trading perpetual futures.
Batasan resmi lainnya: API tidak mendukung Standard Futures; pasangan perpetual TradFi (saham, forex, komoditas, indeks) bisa diperdagangkan lewat API. Presisi harga dan jumlah serta ukuran order minimum diambil dari /openApi/swap/v2/quote/contracts, dan angka di luar presisi akan dipotong.
Biaya dan rebate untuk order API
Order API membayar biaya yang sama dengan order manual, sesuai tingkat VIP Anda: maker 0,02% dan taker 0,05% di perpetual untuk pengguna reguler. Mulai VIP 4, jalur volume BingX mensyaratkan trading API tidak lebih dari 20% volume, sehingga akun kuantitatif biasanya perlu jalur aset untuk mencapai tingkat yang lebih tinggi.
Soal rebate, kami tidak menemukan aturan BingX di halaman publiknya yang menyebut trading API tidak mendapat rebate referral; catatan rebate di akun BingX Anda yang menjadi acuan. Ini berbeda dengan MEXC, yang FAQ afiliasinya menyebut trading API tidak mendapat komisi. Sebagai contoh, volume futures API 5.000.000 USDT sebulan dengan 60% maker dan 40% taker menghasilkan tarif campuran 0,6 × 0,02% + 0,4 × 0,05% = 0,032%, sekitar 1.600 USDT biaya bulanan, dan rebate 45% mengembalikan sekitar 720 USDT. Perbandingan aturan API antar-exchange ada di perbandingan API exchange, dan cara kerja rebate untuk trader kuantitatif di rebate biaya untuk trader kuantitatif.
Daftar BingX dengan kode FEEOTTER dan BingX mengembalikan 45% langsung ke akun BingX Anda, tanpa UID yang perlu diikat di Fee Otter. Fee Otter tidak pernah memerlukan API key, kata sandi, atau izin penarikan Anda. Tarif ini ditetapkan berdasarkan ketentuan kerja sama Fee Otter dengan BingX dan bisa berubah.
Telegram · @feeotter