Pengaturan API KuCoin 2026: Order API Tanpa Rebate, Izin, Batas

Hal terpenting dulu: order yang dikirim lewat API KuCoin tidak mendapat rebate. Aturan di halaman Invite Friends KuCoin menyebut "API trading is currently not eligible for commission", jadi order API dari skrip dan bot Anda sendiri tidak mendapat rebate otomatis 60% dari KuCoin. API-nya tetap bisa dipakai seperti biasa. Saat membuat key, Anda mencatat tiga hal (Key, Secret, Passphrase) dan ketiganya tidak bisa dipulihkan. Akun klasik VIP0 mendapat kuota 4.000 permintaan per 30 detik untuk spot dan 2.000 untuk futures, dan izin penarikan wajib memakai pembatasan IP (dokumen API resmi KuCoin, dicek 2026-10-17).

Panduan ini disusun dari dokumen API resmi KuCoin (kucoin.com/docs-new), halaman Invite Friends, pengumuman program afiliasi, dan data langsung dari API publik. Isinya: cara membuat key, izin mana yang dicentang, beda batas permintaan akun klasik dan akun terpadu, skrip yang bisa langsung dijalankan untuk mengecek tarif biaya, lalu hitungan berapa selisih biaya karena order API tidak mendapat rebate.

Ringkasan

• Order API tanpa rebate: halaman Invite Friends KuCoin menyebut perdagangan API saat ini tidak dihitung untuk komisi. Hitung rebate sebagai 0 saat menghitung biaya strategi.
• Bot trading bawaan KuCoin tetap dihitung: halaman yang sama menyebut komisi berlaku untuk "spot trades (including spot, margin, and trading bots), ETFs, and futures trades". Yang dimaksud adalah bot bawaan KuCoin, bukan program API yang Anda tulis sendiri.
• Tiga kredensial: Key dan Secret dibuat oleh KuCoin, Passphrase Anda tentukan sendiri. Ketiganya tidak bisa dipulihkan; kalau hilang, buat key baru.
• Dua jenis akun, dua model batas permintaan: akun klasik menghitung kuota per 30 detik dan akun utama serta sub-akun terpisah. Akun terpadu (UTA) mendapat 300 permintaan per detik di VIP0, dibagi bersama akun utama dan sub-akunnya.
• Biaya: pada hari pengecekan, perpetual BTC (XBTUSDTM) maker 0,02% dan taker 0,06%, sedangkan spot BTC-USDT masuk kelas A dengan 0,1%.

Order API tanpa rebate: kutipan resmi dan dampaknya

Aturan di halaman Invite Friends KuCoin berbunyi: "API trading is currently not eligible for commission." Rebate dibayar dari komisi yang diberikan bursa kepada perujuk. Order API tidak menghasilkan komisi, jadi tidak ada yang bisa dikembalikan kepada Anda. Pengumuman program afiliasi KuCoin September 2025 tidak punya klausul API tersendiri, tetapi menyebut transaksi tanpa biaya tidak menghasilkan komisi, dan jika tarif komisi afiliasi menjadi 0, cashback pengguna yang diundang juga menjadi 0.

Pengumuman yang sama punya satu aturan lagi: pengguna yang diundang berhenti menghasilkan komisi setelah mencapai level VIP tertentu. Satu bagian menyebut Level 3 ke atas, bagian lain LV4 ke atas. Skrip bervolume besar cepat naik level; lihat level VIP KuCoin.

Selisihnya dalam angka. Misalkan sebuah skrip bertransaksi 2 juta USDT per bulan di perpetual BTC sebagai taker, dengan tarif taker 0,06% pada hari pengecekan:

Ini contoh hitungan kami dengan tarif resmi. Kalau Anda menjalankan strategi API sendiri di KuCoin, biaya yang dibayar penuh. Taker futures KuCoin 0,06% termasuk tinggi di antara bursa besar, jadi strategi yang banyak memakai taker perlu memasukkan biaya ini sejak awal. Perbandingan biaya API antarbursa ada di perbandingan API bursa kripto dan rebate biaya untuk trader kuantitatif.

Dokumen API KuCoin juga menjelaskan Broker Program, terbagi menjadi API broker dan exchange broker, untuk platform yang mengirim order atas nama orang lain. Itu kerja sama antara platform dan KuCoin, terpisah dari rebate kode referal.

Membuat API key: tiga kredensial dan dua jenis akun

1. Masuk lalu buat key di halaman manajemen API, dengan Passphrase buatan Anda sendiri.
2. Catat Key, Secret, dan Passphrase. Dokumen resmi menyebut ketiganya tidak bisa dipulihkan setelah hilang; satu-satunya jalan adalah membuat key baru.
3. Setiap permintaan privat membawa lima header: KC-API-KEY, KC-API-SIGN, KC-API-TIMESTAMP (milidetik), KC-API-PASSPHRASE, dan KC-API-KEY-VERSION. Nomor versi tampil di halaman manajemen API, dan contoh resmi memakai 3.
4. Pastikan akun Anda klasik atau terpadu (UTA). Spot akun klasik memakai https://api.kucoin.com dan futures akun klasik memakai https://api-futures.kucoin.com; akun terpadu memakai https://api.kucoin.com untuk keduanya. KuCoin menyarankan program baru beralih ke akun terpadu dan memakai UTA API V2.

Sumber: KuCoin Authentication, KuCoin API Introduction, dicek 2026-10-17.

Dokumen resmi memuat aturan key sub-akun: maksimal 20 IP per key, dan masa berlaku 30, 90, 180, atau 360 hari atau tanpa batas (Add Sub Account API). Apakah key akun utama tanpa pembatasan IP bisa kedaluwarsa tidak disebut di dokumen resmi yang kami cek; ikuti yang tampil di halaman manajemen API.

Izin mana yang dicentang

Sumber: bagian api-permission di KuCoin API Introduction, dicek 2026-10-17. Dokumen itu juga menyebut bahwa dengan izin Transfer, transfer lewat API tidak memerlukan verifikasi email atau Google. Strategi tidak pernah butuh izin penarikan, jadi jangan dicentang; kalaupun key bocor, orang lain tidak bisa memakainya untuk menarik aset Anda.

Batas permintaan: akun klasik dan akun terpadu dihitung berbeda

Akun klasik

• Satuan: endpoint yang butuh key dibatasi per UID, endpoint publik per IP. Akun utama dan sub-akun punya kuota sendiri-sendiri, jadi strategi bisa dibagi ke sub-akun untuk ruang lebih.
• Melewati batas: Anda menerima HTTP 429 dengan kode galat 429000 dan harus berhenti sampai kuota pulih. Setiap respons membawa gw-ratelimit-limit, gw-ratelimit-remaining, dan gw-ratelimit-reset (milidetik); biarkan skrip membaca ketiganya dan memperlambat diri.
• Dokumennya tidak konsisten: tabel kuota memakai satuan 30 detik, sementara bagian bobot di halaman yang sama menyebut kuota diperbarui tiap 1 detik dan memberi contoh VIP5 700 per detik. Pegang angka di header respons.
• WebSocket: maksimal 800 koneksi bersamaan; 100 pesan per 10 detik per koneksi; maksimal 100 topik per permintaan subscribe; maksimal 400 topik per koneksi spot.

Akun terpadu (UTA)

• Kuota: pool trading (termasuk order WebSocket) 300 per detik di VIP0, 900 di VIP5, dan 4.000 di VIP12; endpoint publik 2.000 per 30 detik.
• Dibagi akun utama dan sub-akun: total ditentukan level VIP dan Anda sendiri yang membaginya ke sub-akun. Sub-akun baru mendapat 10 per detik secara default, di luar total.
• V1 dan V2 satu pool: pindah ke V2 tidak menambah kuota.

Sumber: Rate Limit Rule (Classic), Rate Limit Rule (UTA), dicek 2026-10-17. Trader profesional dan market maker yang butuh kuota lebih bisa mengirim email ke api@kucoin.com berisi akun, alasan, dan perkiraan volume.

Pengujian: jalankan tanda tangan dengan key hanya-baca dulu

Daftar isi dokumen API KuCoin yang kami cek tidak mencantumkan testnet atau lingkungan simulasi. Cara yang lebih aman: buat key yang hanya punya izin General, pastikan tanda tangannya berhasil, lalu ganti ke key dengan izin trading dan uji dengan ukuran order minimum serta leverage rendah.

Contoh di bawah mengecek tarif biaya BTC-USDT akun Anda dan mengikuti aturan tanda tangan resmi: HMAC-SHA256 dari "timestamp + method + path + body" dengan Secret, lalu base64; Passphrase juga di-HMAC-SHA256 dengan Secret, lalu base64. Baca key dari variabel lingkungan, jangan ditulis langsung di kode:

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

KEY = os.environ["KUCOIN_API_KEY"]          # General (read-only) is enough
SECRET = os.environ["KUCOIN_API_SECRET"]
PASSPHRASE = os.environ["KUCOIN_API_PASSPHRASE"]

def b64_hmac(msg):
    return base64.b64encode(hmac.new(SECRET.encode(), msg.encode(), hashlib.sha256).digest()).decode()

path = "/api/v1/trade-fees?symbols=BTC-USDT"
ts = str(int(time.time() * 1000))
headers = {
    "KC-API-KEY": KEY,
    "KC-API-SIGN": b64_hmac(ts + "GET" + path),
    "KC-API-TIMESTAMP": ts,
    "KC-API-PASSPHRASE": b64_hmac(PASSPHRASE),
    "KC-API-KEY-VERSION": "3",
    "Content-Type": "application/json",
}
r = requests.get("https://api.kucoin.com" + path, headers=headers)
print(r.status_code, r.json())

Responsnya berisi tarif maker dan taker akun Anda di BTC-USDT. Kalau tanda tangan gagal, cek dulu apakah method ditulis huruf besar dan path sudah memuat query string; dokumen resmi menyebut keduanya secara khusus.

Biaya: order API memakai tarif biasa

KuCoin tidak menerbitkan tabel biaya khusus API. Data API publik pada hari pengecekan:

Sumber: API publik futures KuCoin, daftar pasangan spot KuCoin (kolom feeCategory), dicek 2026-10-17; tarif kelas B dan C dari struktur biaya VIP di pusat bantuan KuCoin. Saat skrip memindai seluruh pasar, koin kecil kelas C dikenai biaya tiga kali kelas A, jadi cek feeCategory sebelum memilih pasangan. Cara kerja level VIP ada di level VIP KuCoin.

Wilayah layanan

Ketentuan Penggunaan KuCoin (diperbarui 2026-09-29) mencantumkan wilayah terbatas berikut: Amerika Serikat dan wilayahnya, Singapura, Tiongkok daratan dan Hong Kong, Malaysia, Kazakhstan, Uzbekistan, Ontario dan British Columbia di Kanada, Prancis, Belanda, serta wilayah Krimea, Donetsk, Luhansk, Zaporizhzhia, dan Kherson di Ukraina. Daftar ini bisa berubah sewaktu-waktu. Indonesia tidak ada dalam daftar tersebut. Namun di Indonesia, perdagangan aset kripto hanya boleh dilakukan oleh pedagang berizin OJK, dan Satgas PASTI OJK pada Juni 2026 mencantumkan KuCoin dalam daftar entitas yang diajukan untuk diblokir (siaran OJK). Halaman Invite Friends menambahkan bahwa penduduk Belgia, Prancis, Belanda, dan negara lain tidak bisa ikut program referal. Jika strategi berjalan di server cloud, lokasi server dan tempat tinggal Anda sama-sama perlu diperhatikan. Ringkasan per negara ada di lisensi bursa kripto per negara.

Keamanan dan risiko

• Satu key untuk satu keperluan: pisahkan strategi sendiri, bot pihak ketiga, dan alat pencatat pajak, supaya Anda cukup menghapus key yang bermasalah.
• Ikat IP: kalau strategi berjalan di server dengan IP tetap, ikat IP-nya. KuCoin mewajibkan pembatasan IP untuk izin penarikan dan FlexTransfers.
• Pisahkan Passphrase: Passphrase khusus untuk API; jangan sama dengan kata sandi login.
• Risiko kode: bug, koneksi putus, atau lonjakan harga bisa menimbulkan kerugian, dan futures menambah risiko likuidasi. Mulailah dengan dana kecil dan leverage rendah.

Jangan pernah menyerahkan API key kepada siapa pun yang menawarkan jasa trading dengan janji untung pasti, apalagi key yang punya izin penarikan. Kondisi cadangan KuCoin dibahas di proof of reserves KuCoin.

Kalau ingin otomatisasi sekaligus rebate

Di KuCoin, rebate hanya berlaku untuk trading non-API. Daftar dengan kode kami FEEOTTER dan trading manual mendapat rebate biaya 60% (seluruhnya dibayar otomatis oleh KuCoin), sama untuk spot dan futures, tanpa perlu mengajukan penarikan di Fee Otter. Rebate hanya untuk biaya trading, tidak termasuk funding dan likuidasi, dan order lewat API tidak mendapat rebate di KuCoin.

Kalau ingin otomatis tetapi tetap mendapat rebate, mulailah dari bot trading bawaan KuCoin, yang dihitung untuk komisi menurut halaman Invite Friends: lihat panduan bot trading KuCoin. Kalau Anda terutama menulis kode API sendiri, bandingkan aturan bursa lain: pengaturan API Bybit, pengaturan API Binance, pengaturan API OKX. MEXC juga tidak memberi rebate untuk order API; lihat pengaturan API MEXC.

Pertanyaan umum

Apakah order API KuCoin mendapat rebate?

Tidak. Halaman Invite Friends KuCoin menyebut perdagangan API saat ini tidak dihitung untuk komisi, jadi rebate otomatis 60% tidak berlaku untuk order API.

Apakah bot grid bawaan KuCoin mendapat rebate?

Halaman Invite Friends menyebut komisi mencakup spot (termasuk bot trading) dan futures, jadi biaya dari bot bawaan platform termasuk. Catatan rebate Anda yang menjadi acuan akhir.

Saya lupa Passphrase. Bagaimana?

Tidak bisa dipulihkan. Dokumen menyebut Key, Secret, atau Passphrase yang hilang berarti key harus dihapus dan dibuat ulang.

Apa arti 429000?

Anda melewati batas permintaan. Hentikan permintaan, baca angka milidetik di header gw-ratelimit-reset, dan tunggu kuota pulih.

Apakah KuCoin punya testnet?

Daftar isi dokumen API resmi yang kami cek tidak mencantumkannya. Uji tanda tangan dengan key hanya-baca dulu, lalu coba dengan ukuran order minimum.

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

Tidak. Rebate 60% KuCoin dikembalikan otomatis oleh bursa begitu Anda mendaftar dengan kode. Fee Otter tidak pernah meminta API key Anda.

Bacaan lanjutan

• Perbandingan API bursa kripto
• Panduan futures KuCoin
• Panduan rebate biaya KuCoin
• Panduan KuCoin Earn

Izin, batas permintaan, dan aturan tanda tangan diambil dari dokumen API resmi KuCoin; aturan bahwa perdagangan API tidak menghasilkan komisi dari halaman Invite Friends KuCoin; ketentuan afiliasi dari pengumuman KuCoin 2025-09-11; biaya dari API publik KuCoin; semuanya dicek 2026-10-17. KuCoin bisa mengubah batas, biaya, dan ketentuan, jadi halaman resmi terkini yang berlaku. Kode hanya contoh; uji sendiri sebelum memakai dana sungguhan. Tarif rebate ditetapkan bursa dan bisa berubah. Artikel ini hanya informasi, bukan saran investasi.

Data diverifikasi: 2026-10-17