Setup API Bitget 2026: Key, Izin, Rate Limit dan Demo

Buat API key Bitget di menu API Key Management versi web dan Anda mendapat tiga kredensial: APIKey, SecretKey, dan Passphrase. Strategi baru sebaiknya memakai antarmuka V3 Unified Trading Account (UTA), dengan izin seperlunya dan IP yang diikat; batas order 10 kali per detik. Ikat akun dengan kode Fee Otter FEEOTTER untuk rebate futures 50%, tetapi VIP dengan volume 30 hari minimal 50 juta USDT spot atau 100 juta USDT futures dan porsi API 20% atau lebih tidak berhak atas rebate platform (dicek Oktober 2026).

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 Fee Otter dengan kode referral FEEOTTER untuk rebate futures 50%, 2,5 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/...) memakai category untuk 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:

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 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):

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):

1. Login dan beralih ke mode Demo.
2. Buka Personal Center, lalu API Key Management, dan buat Demo API key.
3. Kirim request REST ke api.bitget.com seperti biasa, tapi dengan key demo dan header paptrading: 1.
4. Hubungkan WebSocket ke wss://wspap.bitget.com/v3/ws/public dan wss://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 kode Fee Otter di bawah ambang tersebut mengikuti aturan normal: rebate futures Bitget dari Fee Otter adalah 50%. Dalam angka: volume futures 3 juta USDT per bulan, semua taker, berarti biaya sekitar 1.800 USDT, dengan 50% sekitar 900 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 bervolume besar.

Jika Anda sudah VIP di sebuah exchange atau bertransaksi dalam volume besar dan ingin rebind atau mendaftar di exchange lain, hubungi support Fee Otter. Kami bekerja langsung dengan tim resmi exchange dan bisa membantu mengajukan fasilitas trading khusus (seperti uji coba level VIP) atau rasio rebate yang lebih tinggi, tergantung persetujuan exchange.

Keamanan: key bocor, alat pihak ketiga dan penipuan kelola akun

• Simpan passphrase dan secret dengan benar: ketiga kredensial di environment variable atau secrets manager, jangan di kode, tangkapan layar atau grup chat.
• Satu key per alat pihak ketiga: hanya izin trading, tanpa penarikan, ikat IP bila memungkinkan, dan hapus key saat alat tidak dipakai lagi.
• Jika curiga akun disusupi: salah satu langkah resmi Bitget adalah membuka Profile, lalu API Keys, memeriksa semua key aktif dan menghapus yang tidak dikenal (panduan resmi), bersamaan dengan mengganti password, menghapus perangkat asing dan menghubungi support untuk membekukan akun.

Tolak siapa pun yang meminta API key Anda sambil menjanjikan trading atas nama Anda dengan keuntungan stabil, dan jangan pernah menyerahkan key dengan izin penarikan.

Pada 2026-09-24 Bitget mengumumkan transfer tidak sah dari sebagian hot wallet dan menyatakan saldo pengguna tidak terdampak; kronologi dan rasio cadangannya ada di proof of reserves Bitget. Untuk regulasi dan lisensi per wilayah, lihat perbandingan lisensi exchange.

Pertanyaan umum

Bagaimana jika lupa passphrase API Bitget?

Passphrase tidak bisa dipulihkan atau diubah. Hapus API key tersebut, buat yang baru, dan ganti ketiga kredensial di kode Anda.

Berapa API key yang bisa dimiliki satu akun Bitget?

Quick Start menyebut hingga 50 per UID; subakun bisa membuat sendiri setelah akun utama memberi izin.

Berapa order per detik yang bisa dikirim lewat API Bitget?

Di UTA, order tunggal 10 per detik per UID dan order batch 5 per detik dengan maksimal 20 order per batch; REST dan WebSocket berbagi jatah, dan request berlebih mengembalikan 429.

Bisakah memakai API di demo trading Bitget?

Bisa. Buat API key demo di mode demo, tambahkan header paptrading: 1 pada request REST, dan hubungkan WebSocket ke wspap.bitget.com.

Apakah trading API tetap mendapat rebate Bitget?

Untuk pengguna biasa, rincian penyelesaian yang menentukan. Bitget menyebut dua kasus tidak berhak atas rebate platform: VIP dengan volume spot 30 hari 50 juta atau futures 100 juta USDT atau lebih dan rasio API 20% atau lebih, serta pengguna PRO dan market maker.

Apakah harus memberikan API key ke Fee Otter untuk mengikat rebate?

Tidak. Pengikatan hanya butuh UID, tidak pernah API key, password atau izin penarikan.

Bacaan lanjutan

• Panduan rebate biaya Bitget
• Level VIP dan biaya Bitget
• Copy trading Bitget
• Setup API Bybit
• Setup trading API OKX

Izin, rate limit dan aturan demo trading diambil dari dokumentasi API resmi dan Help Center Bitget, diverifikasi 2026-09-28; Bitget bisa mengubah antarmuka dan batasnya, dan dokumentasi resmi yang berlaku. Kode hanya contoh; uji dulu sebelum trading nyata. Persentase rebate ditetapkan oleh exchange dan platform serta dapat berubah. Hanya untuk informasi, bukan saran investasi.

Data diverifikasi: 2026-09-28

ⓘ Tarif dalam artikel ini untuk futures; spot: Bitget 45%.