Pengaturan API Trading HTX 2026: Izin, IP, Futures V5, Rebate

API key HTX (dulu Huobi) dibuat di menu API Management pada versi web, dan satu key berlaku untuk spot maupun futures. Dokumentasi API HTX mengizinkan hingga 20 key per akun utama, dengan tiga izin (baca, trading, penarikan) dan hingga 20 IP per key. Key tanpa IP terikat kedaluwarsa setelah 90 hari. Ada dua perubahan 2026 yang perlu diketahui: sejak 30 Maret, akun baru yang belum menyelesaikan KYC Level 2 tidak bisa memasang order futures lewat API, dan API lama USDT-M futures sudah dimatikan pada 13 Juli, jadi bot futures harus memakai endpoint V5 (dokumentasi dan pengumuman API HTX, dicek 2026-10-17).

Panduan ini membahas cara membuat key, izin yang perlu dicentang, key sub-akun, tanda tangan dan domain, batas laju spot dan futures, aturan rasio pembatalan, serta cara aturan referral HTX memperlakukan order API. Daftar HTX dengan kode FEEOTTER dan tautkan UID di Fee Otter untuk rebate futures 50% (30% rebate otomatis dari bursa + 20% rebate tambahan), 2,5 kali kode 20% pada umumnya, jadi separuh biaya yang dibayar bot Anda kembali.

Ringkasan

• Lokasi: menu profil → API Management di web. Konfirmasi dengan SMS, email, dan Google Authenticator; Secret Key hanya ditampilkan sekali.
• Tiga izin: baca, trading, penarikan. Izin trading mencakup pasang dan batal order serta transfer. Jangan pernah mengaktifkan izin penarikan pada key bot.
• IP dan masa berlaku: hingga 20 IP (host atau jaringan) per key; key tanpa IP kedaluwarsa setelah 90 hari.
• Syarat KYC: sejak 30 Maret 2026, pengguna baru di bawah KYC Level 2 tidak bisa membuka posisi futures lewat API. Sub-akun mengikuti level akun utama.
• Futures wajib V5: API lama USDT-M futures berhenti pukul 15:59 UTC, 13 Juli 2026.
• Tanpa testnet: HTX menutup testnet spot dan menyarankan pengujian di lingkungan live.
• Rebate: komisi referral dihitung dari biaya bersih spot dan futures, dan order API tidak dikecualikan. Market maker tidak bisa ikut.

Cara membuat key

Berdasarkan artikel bantuan HTX How to apply for API Trading? How to create an API Key? (dicek 2026-10-17):

1. Login di web, klik ikon akun, pilih API Management.
2. Isi catatan (wajib) dan, jika perlu, IP yang ingin diikat, dipisahkan koma.
3. Pilih izin, klik Create, lalu masukkan kode SMS, email, dan Google Authenticator.
4. Access Key dan Secret Key muncul di jendela pop-up. Secret Key hanya tampil saat ini; jika hilang, hapus key dan buat yang baru.
5. Setelah itu Anda bisa mengubah catatan, mengikat IP, atau menghapus key di halaman yang sama.

Artikel itu terbit tahun 2019 dan menyebut 5 key per pengguna dengan saran maksimal 4 IP. Dokumentasi API HTX yang berlaku (Preparation) menyebut 20 key per akun utama dan 20 IP per key. Jika berbeda, ikuti dokumentasi API dan jumlah yang benar-benar bisa dibuat di halaman pengelolaan.

Izin: mana yang perlu diaktifkan

Menurut dokumentasi API, satu key berlaku untuk spot, futures, dan opsi, dengan tiga izin:

Perhatikan bahwa izin trading termasuk transfer, jadi program dengan izin ini bisa memindahkan dana antar akun Anda. Alat pemantau atau pencatatan cukup diberi izin baca.

Key sub-akun

Bagian Sub User di dokumentasi menyebut satu akun utama bisa membuat 200 sub-akun, masing-masing hingga 5 key, dan key sub-akun hanya punya izin baca dan trading, tanpa penarikan. Sub-akun tidak bisa saling transfer; hanya akun utama yang bisa memindahkan dana. Key sub-akun juga bisa diikat IP dengan aturan kedaluwarsa yang sama. Satu strategi per sub-akun membatasi kerugian bila key bocor. Cara volume sub-akun dihitung untuk rebate ada di aturan rebate sub-akun.

Dokumentasi HTX mengingatkan agar Access Key dan Secret Key tidak dibagikan bersama kepada siapa pun, termasuk produk atau orang yang mengaku dari HTX, dan agar key segera dihapus bila bocor. Menautkan akun untuk rebate Fee Otter hanya butuh UID, bukan API key.

Level KYC: batasan API sejak 30 Maret 2026

Pengumuman HTX tentang batas leverage futures dan izin API untuk pengguna baru (berlaku 07:00 UTC, 30 Maret 2026; dicek 2026-10-17) menetapkan untuk pengguna yang baru mendaftar:

• Belum KYC atau baru KYC Level 1: tidak bisa memasang order futures lewat API sampai Level 2 atau lebih selesai.
• Di bawah KYC Level 2: leverage futures maksimal 5x.
• Sub-akun: mengikuti level KYC akun utama dengan batasan yang sama.
• Posisi yang sudah ada: tidak terpengaruh dan pembatalan tetap bisa. Mode hedge bisa memasang order tutup, mode one-way bisa memasang order reduce-only; membuka, menambah, membalik posisi, dan mengubah leverage akan diminta verifikasi dulu.
• Trading bot tidak terpengaruh perubahan ini; Futures Copy Trading terpengaruh.

Persyaratan tiap level KYC ada di panduan KYC HTX.

Domain dan tanda tangan

Dari dokumentasi API:

HTX menyarankan server di AWS Tokyo, tidak menyarankan proxy, dan meminta panggilan API dari luar Tiongkok daratan.

• Metode tanda tangan: HmacSHA256 atau Ed25519, versi tanda tangan 2. String yang ditandatangani terdiri dari metode HTTP, host huruf kecil, path, dan parameter yang diurutkan ASCII serta di-encode URL, disambung baris baru; hasilnya di-encode Base64.
• Timestamp: UTC dengan format YYYY-MM-DDThh:mm:ss, berlaku 5 menit. Jaga jam server tetap sinkron.
• GET dan POST: GET menandatangani semua parameter; POST hanya menandatangani AccessKeyId, SignatureMethod, SignatureVersion, dan Timestamp, sisanya di body.
• Tanda tangan versi baru: API copy trading sudah memakai header API-KEY, API-SIGN, dan API-TIMESTAMP, dan HTX menyebut fitur lain akan menyusul.

Contoh minimal untuk menampilkan daftar akun spot (HmacSHA256). Key dengan izin baca sudah cukup, dan key dibaca dari variabel lingkungan:

import base64, hashlib, hmac, os, urllib.parse
from datetime import datetime, timezone
import requests

ACCESS = os.environ["HTX_ACCESS_KEY"]   # read-only key is enough
SECRET = os.environ["HTX_SECRET_KEY"]
HOST, PATH = "api.huobi.pro", "/v1/account/accounts"

params = {
    "AccessKeyId": ACCESS,
    "SignatureMethod": "HmacSHA256",
    "SignatureVersion": "2",
    "Timestamp": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S"),
}
query = urllib.parse.urlencode(sorted(params.items()), quote_via=urllib.parse.quote)
payload = "\n".join(["GET", HOST, PATH, query])
sig = base64.b64encode(hmac.new(SECRET.encode(), payload.encode(), hashlib.sha256).digest()).decode()

r = requests.get(f"https://{HOST}{PATH}?{query}&Signature={urllib.parse.quote(sig, safe='')}")
print(r.status_code, r.json())

Kami menjalankan kode ini pada 2026-10-17 dengan key palsu dan HTX menjawab api-signature-not-valid (Access Key salah), artinya format permintaan sudah benar. Dengan key Anda sendiri, hasilnya daftar akun Anda.

USDT-M futures: API lama sudah berhenti, pakai V5

Pengumuman upgrade API sistem USDT-M futures HTX (26 Mei 2026) menetapkan masa migrasi dari 08:00 UTC 26 Mei sampai 15:59 UTC 13 Juli 2026. Setelah batas waktu, API lama dihentikan permanen, dan akun yang belum bermigrasi tidak bisa memasang maupun membatalkan order. Semua antarmuka futures selain data pasar (akun, order, posisi, order algo, copy trading) harus diintegrasikan ulang.

• HTX menyarankan membuat sub-akun uji dan memanggil /v5/account/asset_mode untuk memindahkannya ke mode jaminan aset tunggal baru (asset_mode=2) atau multi-aset (asset_mode=1).
• Setelah itu, endpoint privat akun tersebut hanya bisa lewat V5, misalnya POST /v5/trade/order untuk order dan GET /v5/account/balance untuk saldo.
• Sebagian logika trading juga berubah: cross margin kini menghitung potensi rugi dari order terbuka dan bisa memicu pembatalan kontrol risiko, dan likuidasi kini hanya melihat rasio margin pemeliharaan berbasis mark price. Kalibrasi ulang parameter strategi; detailnya di panduan futures HTX.

Untuk spot, dokumentasi menyebut testnet ditutup karena penggunanya sedikit dan biayanya tinggi, dan HTX menyarankan lingkungan live. Tanpa testnet, mulai live dengan ukuran kecil dan leverage rendah.

Batas laju dan aturan rasio pembatalan

Dari dokumentasi API (dicek 2026-10-17):

Respons spot membawa X-HB-RateLimit-Requests-Remain dan respons futures membawa ratelimit-remaining, sehingga kode Anda bisa memperlambat sendiri. Akun utama dan sub-akun dihitung terpisah.

Rasio pembatalan: di USDT-M futures, bila pengguna API memasang 3.000 order limit, post-only, FOK, atau IOC atau lebih dalam 10 menit, HTX menghitung rasio pembatalan. Di atas 99%, keempat jenis order itu diblokir 5 menit; tiga kali blokir dalam satu jam berarti 30 menit. "Pembatalan tidak valid" adalah order tanpa eksekusi yang dibatalkan dalam 3 detik setelah dipasang. Pembatalan dan jenis order lain tetap berfungsi selama blokir. Jika strategi Anda sering memasang dan membatalkan order, cek rasio ini sebelum live.

Biaya dan rebate untuk order API

Biaya: pengguna biasa HTX (Prime 0) membayar 0,2% maker dan taker di spot, serta 0,02% maker / 0,06% taker di USDT-M futures. Dengan volume futures 30 hari 5 juta USDT Anda mencapai Prime 2 dengan taker 0,05% (tabel lengkap di tingkat VIP dan biaya HTX). HTX tidak mencantumkan tarif API terpisah; halaman tarif di akun Anda yang berlaku.

Rebate: menurut Rules for HTX's Referral Program (dicek 2026-10-17), pengundang mendapat bagian dari biaya trading bersih yang benar-benar dibayar undangan di spot atau futures. Aturan ini tidak mengecualikan order API, tetapi yang berikut dikecualikan atau dibagi:

• Biaya dari transaksi dengan voucher cashback spot, bonus uji futures, biaya nol, atau biaya negatif.
• Market maker tidak berhak ikut program referral, dan program market maker di dokumentasi API menyebut market maker tidak bisa memakai kartu poin, tarif VIP, atau rebate.
• Pengguna Prime 9 ke atas tidak lagi menghasilkan bonus referral untuk pengundangnya.
• Order lewat broker: minimal 70% untuk pengundang dan maksimal 30% untuk broker.

Jadi akun biasa yang bertransaksi lewat kode sendiri atau API mendapat komisi seperti transaksi spot atau futures lain, selama biaya dibayar; cek laporan rebate Anda untuk memastikan. MEXC berbeda: aturan afiliasinya menyebut transaksi API sama sekali tidak menghasilkan komisi.

Pada ukuran bot yang umum: volume futures bulanan 5 juta USDT, semua taker, menempatkan Anda di Prime 2 dengan taker 0,05%, jadi biayanya 2.500 USDT. Lewat Fee Otter 50% kembali, yaitu 1.250 USDT: 750 USDT dikembalikan HTX ke akun Anda dan 500 USDT diselesaikan harian oleh Fee Otter. Kode 20% pada umumnya mengembalikan 500 USDT.

Ini contoh kami sendiri dengan tarif resmi HTX; riwayat transaksi dan laporan rebate Anda yang menentukan. Rebate hanya berlaku untuk biaya trading, bukan funding. Tangkapan layar rebate HTX ada di halaman tarif rebate, langkah pendaftaran di cara daftar HTX. Kode referral HTX tidak bisa diganti setelah terikat; jika Anda mendaftar dengan kode orang lain, lihat panduan ganti ikatan HTX. Perkiraan untuk beberapa bursa ada di rebate biaya untuk trader kuantitatif.

Jika Anda sudah VIP di sebuah bursa atau bertransaksi dalam volume besar dan ingin pindah atau membuka akun di bursa lain, hubungi dukungan Fee Otter. Kami berkomunikasi langsung dengan tim bursa untuk mengajukan manfaat trading khusus atau rebate lebih tinggi; keputusan ada di bursa.

Keamanan: satu key untuk satu keperluan

• Key terpisah untuk strategi sendiri, bot pihak ketiga, dan alat pencatatan, masing-masing dengan izin seperlunya.
• Ikat IP: halaman praktik terbaik HTX sangat menyarankannya, dan key tanpa IP mati setelah 90 hari. Jika semua permintaan tiba-tiba gagal autentikasi, cek ini dulu.
• Platform pihak ketiga hanya diberi izin baca atau trading, tidak pernah penarikan. Hapus key saat berhenti memakai layanannya.
• Jangan simpan key di version control: gunakan variabel lingkungan atau pengelola rahasia, bukan tangkapan layar atau grup chat.

Wilayah layanan

Pasal 1.2 Perjanjian Pengguna HTX (diperbarui September 2026, dicek 2026-10-17) menutup semua layanan di Tiongkok daratan, AS, Hong Kong, Inggris, Singapura, Rusia, semua negara anggota UE, dan wilayah lain yang tercantum. Pengguna dari Israel, Irak, Bangladesh, Bolivia, Ekuador, Kirgizstan, dan Selandia Baru tidak bisa trading derivatif. Indonesia tidak ada di daftar tersebut. Namun di Indonesia, perdagangan aset kripto hanya boleh dilakukan oleh pedagang berizin OJK, dan Satgas PASTI OJK pada Juni 2026 mencantumkan HTX dalam daftar entitas yang diajukan untuk diblokir (siaran OJK). Pada Mei 2026 pemerintah Inggris memasukkan Huobi Global S.A., operator HTX, ke daftar sanksi terkait Rusia (pemberitahuan pemerintah Inggris). Ringkasan per negara ada di lisensi bursa kripto per negara.

Risiko

Bug lebih mahal daripada kesalahan manual. Tanda tangan atau timestamp yang salah hanya membuat order gagal, tetapi satuan jumlah atau leverage yang salah bisa membuka posisi jauh lebih besar dari yang dimaksud. HTX tidak punya testnet spot, dan futures baru pindah ke V5 dengan aturan likuidasi baru, jadi jalankan dengan ukuran kecil dulu. Simpan di bursa hanya dana yang sedang dipakai strategi; cadangan HTX dibahas di proof of reserves HTX. Jangan serahkan API key kepada siapa pun yang menawarkan pengelolaan dana atau menjanjikan keuntungan.

FAQ

Di mana membuat API key HTX?

Ikon profil → API Management di web. Konfirmasi dengan SMS, email, dan Google Authenticator; Secret Key ditampilkan sekali.

Kapan API key HTX tanpa IP kedaluwarsa?

Setelah 90 hari. Ikat IP (hingga 20 per key) agar tidak kedaluwarsa.

Mengapa API saya tidak bisa memasang order futures?

Akun yang terdaftar setelah 30 Maret 2026 tanpa KYC Level 2 tidak bisa memasang order futures lewat API. Selain itu, API lama USDT-M futures berhenti pada 13 Juli 2026; Anda perlu endpoint V5.

Apakah HTX punya testnet API?

Tidak. Testnet spot sudah ditutup dan HTX menyarankan pengujian di lingkungan live.

Apakah transaksi API mendapat rebate di HTX?

Aturan referral HTX membayar dari biaya bersih spot dan futures dan tidak mengecualikan order API. Market maker, pengguna Prime 9+, serta transaksi dengan bonus uji, biaya nol, atau negatif dikecualikan. Laporan rebate Anda yang menentukan.

Apakah Fee Otter butuh API key saya?

Tidak. Penautan hanya butuh UID. Fee Otter tidak pernah meminta API key dan tidak pernah bertransaksi atas nama Anda.

Bacaan lanjutan

• Panduan rebate biaya HTX
• Perbandingan API bursa kripto
• Pengaturan API trading Bybit
• Pengaturan API trading OKX

Izin, batas laju, tanda tangan, dan aturan migrasi diambil dari dokumentasi API resmi HTX dan pengumuman pusat bantuannya, dicek 2026-10-17. Artikel bantuan tentang pembuatan key terbit tahun 2019, jadi tampilan dan batasnya mungkin sudah berubah. HTX bisa mengubah batas dan aturan; dokumentasi resminya yang berlaku. Kode hanya contoh; uji dulu sebelum trading live. Tarif rebate ditetapkan bursa dan platform dan bisa berubah. Artikel ini informasi, bukan saran investasi.

Data diverifikasi: 2026-10-17

ⓘ Tarif rebate Fee Otter adalah untuk futures kecuali ditandai spot; spot: HTX 45% (30% otomatis + 15% tambahan).