Pada 2026, API Bitget berpusat pada antarmuka V3 dari Unified Trading Account (UTA), sementara akun klasik masuk mode pemeliharaan. Panduan ini mengikuti dokumentasi API resmi dan Help Center Bitget (diverifikasi 2026-09-28) sesuai urutan integrasi: pilih mode akun, buat API key beserta tiga kredensialnya, atur izin dan IP, pahami tanda tangan dan rate limit, jalankan di demo trading, dan terakhir bagian yang paling sering terlewat: Bitget menyatakan secara tertulis bahwa pengguna bervolume besar yang dominan trading lewat API bisa kehilangan hak rebate platform. Ikat Bitget ke Quant Nova dengan kode referral NOVA888, pengguna baru dapat rebate futures 40% di Lv.1, dua kali kode referral umum 20%, selisih yang terus bertambah tiap bulan untuk program yang sering bertransaksi.
Pilih mode akun dulu: unified atau klasik
Bitget kini punya dua set dokumentasi API. Dokumentasi akun klasik dibuka dengan rekomendasi memakai Unified Trading Account dan menyebut akun klasik dalam mode pemeliharaan, hanya menerima pembaruan penting (Classic Introduction). Perbedaannya:
- Unified Trading Account (UTA): spot, margin, serta futures USDT, USDC dan coin-margined berbagi satu pool margin, dan satu antarmuka V3 (path
/api/v3/...) memakaicategoryuntuk memilih produk. - Akun klasik: aset berada di akun spot, futures dan lainnya secara terpisah (misalnya USDT harus di akun futures untuk trading futures), memakai antarmuka V2.
Tulis strategi baru untuk UTA; kode V2 yang sudah berjalan di akun klasik tetap bisa dipakai, tapi akun klasik hanya menerima pembaruan penting, dan sebagian fitur, seperti pembatalan otomatis saat terputus di bawah, hanya ada di UTA. Cara integrasi tidak memengaruhi rebate: pengikatan hanya butuh UID, tidak pernah API key.
Satu API key Bitget punya tiga kredensial
Login di website dan buat di API Key Management. Menurut Quick Start resmi (Quick Start), Anda mendapat tiga hal:
| Nama | Apa itu | Perhatikan |
|---|---|---|
| APIKey | Identitas trading API, dibuat acak | Dikirim di header setiap request |
| SecretKey | Kunci privat buatan sistem untuk tanda tangan | Jangan dibagikan |
| Passphrase | Password API yang Anda tetapkan sendiri | Tidak bisa diubah; jika lupa, hapus dan buat ulang key |
Peringatan risiko Bitget sangat lugas: bocornya salah satu dari ketiganya bisa menyebabkan kehilangan aset, dan key yang bocor harus segera dihapus. Setiap UID bisa membuat hingga 50 API key, masing-masing read-only atau read-write.
Key subakun: subakun virtual dan standar bisa membuat dan mengelola API key sendiri, asalkan akun utama mengaktifkan izin API Key Management untuk subakun tersebut, yang secara default nonaktif; akun utama bisa melihat, mengubah atau menghapus key subakun kapan saja. Satu strategi per subakun membuat masalah tetap terisolasi.
Izin dan pengikatan IP
Panduan quick start resmi mencantumkan dua kelompok izin UTA, trading dan manajemen, masing-masing dengan read-only dan read-write; izin penarikan ditentukan tersendiri di endpoint penarikan:
| Izin | Yang diizinkan | Untuk strategi |
|---|---|---|
| UTA trade (read-only) | Melihat informasi trading | Monitoring dan pencatatan |
| UTA trade (read-write) | Memasang dan membatalkan order | Diperlukan untuk trading |
| UTA management (read-only) | Melihat informasi akun dan tarif biaya | Diperlukan untuk saldo dan biaya |
| UTA management (read-write) | Pengaturan akun seperti leverage dan holding mode | Hanya jika strategi mengatur leverage |
| UTA withdrawal | Memanggil endpoint penarikan (on-chain dan transfer internal) | Jangan diaktifkan |
Izin penarikan adalah yang tertulis "Permission: UTA withdrawal" pada endpoint resmi /api/v3/account/withdrawal (dokumentasi Deposit/Withdrawal). Strategi trading tidak pernah butuh penarikan; jika diaktifkan, key yang bocor berubah dari "order liar" menjadi "aset hilang".
Pengikatan IP: Quick Start dua kali menyebut, di tips keamanan dan peringatan risikonya, bahwa mengikat alamat IP saat membuat API key sangat disarankan. Menurut endpoint key subakun, satu key bisa mengikat hingga 30 IP, hanya IPv4. Soal apakah key tanpa IP kedaluwarsa, per 2026-09-28 kami tidak menemukan pernyataan di dokumentasi API resmi maupun Help Center Bitget, jadi ikuti yang tampil di halaman pembuatan; apa pun itu, jika server Anda punya IP keluar tetap, ikat IP tersebut.
Tanda tangan, timestamp dan contoh
Setiap request REST membawa empat header: ACCESS-KEY, ACCESS-SIGN, ACCESS-TIMESTAMP dan ACCESS-PASSPHRASE. Tanda tangan dibuat dengan HMAC-SHA256 memakai SecretKey atas timestamp + metode huruf besar + path request + (? dan query string, jika ada) + body, lalu di-encode Base64; tanda tangan RSA juga didukung. Timestamp login WebSocket kedaluwarsa setelah 30 detik, dan Bitget menyarankan jam host disinkronkan dengan server.
Potongan ini memakai izin management read-only untuk mengambil tarif biaya futures Anda, sekaligus membuktikan tanda tangan sudah benar. Key diambil dari environment variable:
import base64, hmac, os, time, requests
KEY = os.environ["BITGET_KEY"]
SECRET = os.environ["BITGET_SECRET"]
PASSPHRASE = os.environ["BITGET_PASSPHRASE"]
path = "/api/v3/account/fee-rate"
query = "category=USDT-FUTURES&symbol=BTCUSDT" # keys sorted A-Z
ts = str(int(time.time() * 1000))
prehash = ts + "GET" + path + "?" + query
sign = base64.b64encode(
hmac.new(SECRET.encode(), prehash.encode(), "sha256").digest()
).decode()
r = requests.get("https://api.bitget.com" + path + "?" + query, headers={
"ACCESS-KEY": KEY, "ACCESS-SIGN": sign, "ACCESS-TIMESTAMP": ts,
"ACCESS-PASSPHRASE": PASSPHRASE, "Content-Type": "application/json",
})
print(r.json(), r.headers.get("x-mbx-used-remain-limit"))Header respons x-mbx-used-remain-limit menunjukkan sisa jatah endpoint tersebut, sehingga kode bisa memperlambat diri. Untuk demo trading, lihat bagian demo di bawah.
Rate limit: REST dan WebSocket berbagi satu jatah
Aturan umum di Quick Start: request yang terlalu sering mengembalikan 429 Too Many Requests; batas tiap endpoint tercantum di halamannya dan dihitung terpisah; REST dan WebSocket berbagi kuota rate limit yang sama; dan domain umum punya batas keseluruhan 6.000 request per IP per menit. Endpoint trading umum (UTA, dokumentasi Order Management, diverifikasi 2026-09-28):
| Endpoint | Fungsi | Batas | Catatan |
|---|---|---|---|
| /api/v3/trade/place-order | Pasang order | 10/detik per UID | Token saham (rToken) terpisah 5/detik |
| /api/v3/trade/place-batch | Order batch | 5/detik per UID | Maksimal 20 order per batch |
| /api/v3/trade/modify-order | Ubah order | 10/detik per UID | Tidak boleh diulang sebelum hasil keluar |
| /api/v3/trade/cancel-order | Batalkan order | 10/detik per UID | |
| /api/v3/trade/cancel-batch | Batal batch | 5/detik per UID | Maksimal 20 per batch; boleh sukses sebagian |
| /api/v3/trade/cancel-symbol-order | Batalkan semua per simbol | 5/detik per UID | |
| /api/v3/trade/unfilled-orders | Order terbuka | 20/detik per UID | Maksimal 400 order terbuka masing-masing untuk futures dan spot |
| /api/v3/account/fee-rate | Tarif biaya | 3/detik per UID | |
| /api/v3/account/withdrawal | Penarikan | 1/detik per UID | Butuh izin penarikan |
Aturan WebSocket (sama di dokumentasi UTA dan klasik):
- Maksimal 300 request koneksi per IP per 5 menit, dan maksimal 100 koneksi per IP.
- Maksimal 240 request langganan per jam per koneksi dan 1.000 channel per koneksi; Bitget sangat menyarankan kurang dari 50 channel per koneksi agar stabil.
- Kirim string "ping" setiap 30 detik dan sambung ulang jika tidak ada "pong"; server memutus koneksi setelah 2 menit tanpa ping.
- Tiap koneksi menerima maksimal 10 pesan per detik (ping, login, langganan); jika lewat, koneksi diputus, dan IP yang berulang kali diputus bisa diblokir.
Panduan best practice Bitget menyarankan berlangganan channel order lewat WebSocket sebelum memasang order dan mengisi clientOid sendiri; respons order sukses hanya berarti exchange menerima request dan memberi ID, sedangkan apakah order masuk matching terlihat di channel order.
Opsi tambahan untuk akun besar: countdown cancel-all (countdown-cancel-all, membatalkan semua order jika tidak ada heartbeat dalam jendela 5 sampai 60 detik) hanya untuk UTA dan harus diajukan lewat tim bisnis Bitget; jalur VIP dan jalur latensi rendah Lo-La juga untuk pengguna VIP dan institusi lewat pengajuan. Sejak 2026-09-03, pengguna market maker dan PRO di UTA memakai kerangka rate limit institusional baru: hingga 600 request per detik per akun dan hingga 120.000 per detik untuk gabungan akun utama dan subakun, sementara akun klasik tidak berubah (pengumuman resmi).
Demo trading: jalankan dulu dengan API key demo
Demo trading Bitget memakai dana virtual pada harga pasar nyata. Help Center memberi contoh 50.000 USDT dan mencantumkan perpetual USDT-M seperti BTCUSDT dan ETHUSDT, coin-margined BTCUSD dan ETHUSD, serta USDC-M BTCUSDC dan ETHUSDC; dana virtual tidak bisa ditarik atau dipindahkan ke akun nyata, dan semua pengguna bisa memakainya secara default (What Is Demo Trading on Bitget Futures). Cara memakainya lewat API (Quick Start resmi):
- Login dan beralih ke mode Demo.
- Buka Personal Center, lalu API Key Management, dan buat Demo API key.
- Kirim request REST ke api.bitget.com seperti biasa, tapi dengan key demo dan header
paptrading: 1. - Hubungkan WebSocket ke
wss://wspap.bitget.com/v3/ws/publicdanwss://wspap.bitget.com/v3/ws/private.
Berbeda dengan domain demo terpisah milik Bybit, REST demo Bitget memakai domain yang sama dengan trading nyata, dan hanya header paptrading yang membedakannya, jadi jadikan paptrading pengaturan eksplisit di kode agar uji coba tidak mengenai akun nyata. Help Center juga menyebut harga demo mengikuti pasar nyata tapi bisa sedikit tertunda karena latensi jaringan.
Biaya dan aturan rebate untuk trading API
Biaya: jadwal biaya Bitget ditentukan oleh level VIP, dengan VIP0 sebesar 0,1% / 0,1% di spot dan 0,02% maker / 0,06% taker di futures, tanpa tarif API tersendiri; cek tarif Anda dengan /api/v3/account/fee-rate di atas. Ambang dan tarif tiap level ada di level VIP Bitget.
Rebate: program afiliasi Bitget mendefinisikan rebate sebagai biaya bersih × rasio rebate, dengan biaya bersih adalah yang benar-benar dibayar setelah potongan; order API tidak disebut secara khusus, jadi untuk pengguna biasa apakah biaya dari API dihitung ditentukan oleh rincian penyelesaian. Namun Bitget punya tiga pengecualian tertulis terkait API:
- VIP bervolume besar dengan API ≥ 20%: halaman biaya Bitget menyebut pengguna VIP dengan volume spot 30 hari 50 juta USDT atau lebih, atau volume futures 100 juta USDT atau lebih, yang trading API-nya 20% atau lebih dari total volume, tidak berhak atas rebate platform (halaman biaya Bitget).
- Pengguna PRO: PRO mensyaratkan volume sekaligus rasio API minimal 20%; PRO1 adalah volume spot 30 hari di atas 50 juta atau futures di atas 100 juta USDT, dan rasio API = (volume spot API + volume futures API) ÷ (total spot + total futures). Aturan PRO menyebut "No upstream commission", sehingga perujuk tidak menerima bagian biaya dari pengguna tersebut; pengguna PRO dan market maker juga tidak berhak atas diskon biaya atau rebate platform lainnya (penjelasan PRO Bitget).
- Pengguna institusi: Bitget menyebut sistem VIP dan aturannya hanya berlaku untuk pengguna non-institusi.
Mencapai PRO lewat volume API memberi biaya tercantum lebih rendah dan rate limit lebih tinggi, tetapi rebate platform berhenti. Jika akun Anda bertransaksi mendekati 100 juta USDT per bulan dan dominan lewat API, hitung dulu mana yang lebih murah: biaya PRO atau biaya VIP ditambah rebate.
Pengguna quant di bawah ambang tersebut mengikuti aturan normal: rebate futures Bitget dari Quant Nova adalah 40% di Lv.1 untuk pengguna baru, 45% di SVIP (bisa dicapai lewat volume) dan hingga 50% di level berbasis undangan; spot 40% / 45% / 45%. Dalam angka: volume futures 3 juta USDT per bulan, semua taker, berarti biaya sekitar 1.800 USDT, sudah mencapai Lv.4 (biaya 1.000 USDT dalam 30 hari) dengan 43%, sekitar 774 USDT kembali tiap bulan; kode umum 20% hanya mengembalikan 360 USDT. Lihat panduan rebate biaya Bitget, panduan rebind Bitget untuk akun lama, dan rebate biaya untuk trader quant.
Jika Anda sudah VIP di exchange lain atau bertransaksi dalam volume besar, hubungi support Quant Nova: kami bekerja langsung dengan tim resmi exchange untuk membantu Anda mendapatkan manfaat seperti uji coba level VIP, tergantung persetujuan exchange.
Telegram · @quant_nova
LINE · @238pqnkj
