Akses API XT.COM tidak langsung aktif. Anda harus mengajukan API trading lebih dulu di menu "API Management" di website dengan klik "Create API"; menurut XT.COM, peninjauan memakan 3 sampai 5 hari kerja dan lebih cepat jika saldo akun di atas 50.000 USDT. Key baru bisa dibuat setelah disetujui. Setiap akun bisa punya hingga 10 key, whitelist IP bersifat opsional dan menerima IP tunggal atau rentang IP, dan key baru hanya punya izin query, jadi izin trading dan penarikan harus diaktifkan terpisah. Order spot dibatasi 20 per detik dan order futures 200 per detik per key, dan tidak semua pasangan terbuka untuk API (dicek 2026-10-17).
Panduan ini disusun dari artikel pusat bantuan XT.COM tentang pengajuan API trading dan dokumentasi resmi API di doc.xt.com. Isinya: pengajuan dan pembuatan key, izin dan whitelist IP, dua skema tanda tangan yang berbeda untuk spot dan futures, batas permintaan, pasangan yang bisa ditradingkan lewat API, dan apa kata halaman XT.COM soal biaya serta rebate untuk order API. Daftar di XT.COM dengan kode FEEOTTER untuk rebate futures 70% (60% rebate otomatis dari bursa + 10% rebate tambahan), 3,5 kali kode umum 20%; XT.COM tidak menyebut apakah order API dihitung, dan di bawah kami jelaskan cara mengeceknya.
Ringkasan
- Ajukan dulu, baru buat key: API Management → Create API → Submit for Review, 3 sampai 5 hari kerja; XT.COM menyarankan saldo di atas 50.000 USDT agar lebih cepat.
- Jumlah: hingga 10 key di akun utama, dan hingga 10 di setiap sub-akun.
- Izin: default hanya query; trading dan penarikan perlu otorisasi terpisah. Biarkan izin penarikan nonaktif untuk key strategi apa pun.
- Secret hanya tampil sekali: tidak bisa dipulihkan; hapus key lalu buat yang baru.
- Dua host, dua tanda tangan: spot di
sapi.xt.com; futures USDT-M difapi.xt.comdan coin-M didapi.xt.com. Spot dan futures menyusun string yang ditandatangani dengan cara berbeda. - Rebate: aturan referral XT.COM tidak menyebut API, jadi catatan rebate Anda yang menunjukkan apakah trade API dihitung. Mengikat rebate hanya butuh UID, tidak pernah API key.
Langkah 1: ajukan API trading
Dari How to apply for API trading and create an API key (dicek 2026-10-17):
- Login di www.xt.com dan klik "API Management" di User Center.
- Klik "Create API", lalu "Submit for Review" untuk mengajukan API trading.
- Tunggu peninjauan. Menurut XT.COM, izin API melewati tinjauan kontrol risiko, biasanya 3 sampai 5 hari kerja, dan saldo di atas 50.000 USDT mempercepatnya.
Halaman resmi tidak menyebut apakah akun dengan saldo jauh di bawah 50.000 USDT akan disetujui atau ditolak; yang disebut hanya syarat agar tinjauan lebih cepat. Jika berencana menjalankan bot, ajukan seminggu sebelum ingin mulai.
Langkah 2: buat key
- Setelah disetujui, kembali ke "API Management".
- Isi "Alias Name" (wajib) dan "Whitelist IP" (opsional). Whitelist menerima IP tunggal atau rentang IP, dipisahkan koma, misalnya
192.168.1.1, 192.168.1.2. - Masukkan kode verifikasi Google dan klik "Create API".
- Public Key dan Private Key (secret) hanya tampil sekali. Simpan segera dan jangan bagikan halaman itu.
- Setelah itu Anda bisa "Modify" alias, izin, dan IP, atau "Delete" key.
Sub-akun: User Center → Sub-account → API Management, pilih sub-akun lalu klik "Create API", kemudian lewati pemeriksaan keamanan. Menurut Sub-Account FAQs, setiap sub-akun bisa punya hingga 10 key untuk order, query, dan pengelolaan posisi, dan transfer antara akun utama dan sub-akun gratis. Satu strategi per sub-akun membuat batas dan risiko terpisah.
Izin dan whitelist IP
- Default hanya baca: menurut XT.COM, key baru hanya punya izin query; layanan trading dan penarikan baru berfungsi setelah Anda mengotorisasinya. Alat pemantauan atau pembukuan cukup memakai default.
- Earn punya izin sendiri: dokumentasi Earn API mewajibkan izin Earn untuk endpoint langganan dan penebusan.
- Error izin: kode error
AUTH_106berarti "exceeded apikey permission" danAUTH_104berarti "unbound IP request"; sisi futures mengembalikan HTTP 403 jika IP tidak ada di whitelist (kode respons spot, kode error futures). - Masa berlaku: halaman resmi tidak menyebut apakah key tanpa whitelist IP akan kedaluwarsa.
Jika bot berjalan di server cloud dengan IP tetap, masukkan IP keluar server itu ke whitelist. XT.COM juga menyarankan tidak terhubung lewat proxy karena latensi tinggi dan tidak stabil.
Tanda tangan: spot dan futures berbeda
Spot (sapi.xt.com)
Dari Signature generation dan Signature Instructions:
- Header:
validate-algorithms(disarankan HmacSHA256),validate-appkey,validate-recvwindow,validate-timestamp(milidetik), danvalidate-signature. - X: empat header pertama diurutkan menurut abjad dan digabung dengan
&. - Y:
#method#path#query#body; urutkan kunci query, tandatangani body JSON sebagai string mentah tanpa diubah urutannya, dan hilangkan bagian yang kosong. - Tanda tangan: HmacSHA256 dari X + Y dengan secret Anda, dalam heksadesimal.
- Waktu: waktu server dikurangi timestamp harus di bawah recvwindow (default 5 detik, dan XT.COM tidak menyarankan lebih dari 5); timestamp yang lebih cepat lebih dari 1 detik dari server juga ditolak (
AUTH_105). Jaga jam host tetap tersinkron NTP.
Futures (fapi.xt.com / dapi.xt.com)
Menurut halaman tanda tangan futures, string yang ditandatangani adalah validate-appkey=…&validate-timestamp=…, lalu # dan path endpoint, lalu # dan query string atau body, ditandatangani dengan HmacSHA256. Kirim header validate-appkey, validate-timestamp, dan validate-signature. recvwindow futures juga default 5 detik, maksimal 60 detik.
Contoh minimal untuk membaca saldo USDT spot (GET /v4/balances). Key diambil dari environment variable, tidak ditulis langsung di kode; jalankan dulu dengan key hanya-baca:
import hashlib, hmac, os, time, requests
KEY = os.environ["XT_API_KEY"] # read-only key is enough
SECRET = os.environ["XT_API_SECRET"]
HOST = "https://sapi.xt.com"
path, query = "/v4/balances", "currencies=usdt"
headers = {
"validate-algorithms": "HmacSHA256",
"validate-appkey": KEY,
"validate-recvwindow": "5000",
"validate-timestamp": str(int(time.time() * 1000)),
}
x = "&".join(f"{k}={headers[k]}" for k in sorted(headers))
y = f"#GET#{path}#{query}"
headers["validate-signature"] = hmac.new(
SECRET.encode(), (x + y).encode(), hashlib.sha256).hexdigest()
headers["Content-Type"] = "application/json"
r = requests.get(f"{HOST}{path}?{query}", headers=headers)
print(r.status_code, r.json().get("rc"), r.json().get("mc"))Jika muncul AUTH_103 (tanda tangan salah), periksa apakah query string sudah diurutkan, urutan header di X, dan apakah ada spasi yang ikut tersalin bersama secret.
Batas permintaan
Dokumentasi XT.COM mencantumkan batas di setiap endpoint, ditambah beberapa aturan umum (dicek 2026-10-17):
| Area | Endpoint | Batas |
|---|---|---|
| Spot | Pasang order POST /v4/order | 20 per detik per apikey |
| Spot | Saldo GET /v4/balances | 10 per detik per apikey |
| Futures | Buat order /future/trade/v1/order/create | 200 per detik per apikey |
| Futures (aturan umum) | Endpoint aset | 3 per detik |
| Futures (aturan umum) | Endpoint lain | 10 per detik per pengguna, 1.000 per menit per IP |
Aturan umum futures menyebut "10 requests per second per user" untuk endpoint lain, sedangkan halaman create order menyebut 200 per detik; keduanya tidak cocok, jadi percayai respons yang sebenarnya. Melewati batas mengembalikan HTTP 429 dan bisa memblokir IP atau key, dan dokumentasi futures menyebut akun dikunci 10 menit. Atur frekuensi di kode Anda sendiri, jangan menunggu 429.
Tidak semua pasangan terbuka untuk API
Pengumuman pembukaan API XT.COM tahun 2023 menyebut API dibuka "untuk sebagian pasangan trading". Data publik pada 2026-10-17: dari 1.032 pasangan online yang bisa ditradingkan di API simbol spot, 484 bertanda openapiEnabled; dari 723 kontrak yang tampil dan bisa ditradingkan di API simbol futures, 662 bertanda isOpenApi. BTC_USDT dan ETH_USDT terbuka di spot maupun futures. Cek pasangan Anda di dua endpoint publik ini sebelum mulai.
Dokumentasi resmi API tidak menyediakan host testnet. XT.COM punya demo trading futures berbasis web, tetapi halamannya tidak menyebut bisa diakses lewat API, jadi pengujian berarti order live kecil. Cek ukuran order, presisi, dan nilai nosional minimum di spesifikasi pasangan lebih dulu.
Biaya dan rebate untuk order API
Biaya: API publik pada 2026-10-17 menunjukkan BTC_USDT spot 0,2% untuk maker dan taker, dan BTC_USDT futures 0,04% maker serta 0,06% taker. XT.COM tidak mencantumkan jadwal biaya khusus API; cara level VIP menurunkan biaya ada di level VIP XT.COM.
Rebate: halaman referral dan afiliasi XT.COM menyebut komisi dibayar dari setiap biaya trading valid yang dihasilkan pengguna undangan di spot, margin, dan futures. Halaman itu tidak menyebut API, tidak mengecualikan order API dan tidak memastikan order API dihitung, jadi apakah biaya API dihitung terlihat di catatan rebate Anda. Skema terkait tetapi terpisah adalah XT Broker Program untuk platform trading, penyedia bot, dan pihak lain yang memasang order untuk pengguna lewat API. Broker yang disetujui mengikat Broker ID ke trade API mereka, dan XT.COM mengiklankan rebate bertingkat hingga 60% serta batas API lebih tinggi. Halaman resmi tidak menyebut apakah rebate broker bisa digabung dengan komisi referral.
Jangan pernah memberikan API key kepada siapa pun yang menawarkan trading atas nama Anda atau menjanjikan untung pasti, dan jangan pernah menyerahkan key dengan izin penarikan. Penipuan sering menawarkan skema "pasti untung" atau "imbal hasil tinggi, risiko rendah", lalu meminta biaya pembukaan blokir, deposit, atau pajak sebelum dana bisa ditarik.
Rasio Fee Otter untuk XT.COM adalah 70% untuk futures (60% rebate otomatis dari bursa + 10% rebate tambahan) dengan kode FEEOTTER. Pada volume bot yang umum, 5 juta USDT per bulan, semuanya taker, biayanya 3.000 USDT. Jika trade API dihitung, sekitar 2.100 USDT kembali setiap bulan, dibandingkan 600 USDT dengan kode umum 20%. XT.COM membayar 60% langsung ke akun bursa Anda dan Fee Otter menyelesaikan 10% setiap hari; tangkapan layarnya ada di halaman rasio rebate. Sebelum menaikkan volume, pasang beberapa order API kecil dan cek catatan rebate keesokan harinya. Langkah pendaftaran ada di cara daftar XT.COM, pengguna lama bisa mengikuti panduan rebind XT.COM, dan contoh antarbursa ada di rebate biaya untuk trader kuantitatif.
Jika Anda sudah VIP di sebuah bursa atau trader frekuensi tinggi bervolume besar dan ingin pindah atau daftar di tempat lain, hubungi support Fee Otter. Kami bekerja langsung dengan tim resmi bursa untuk mengajukan keuntungan trading khusus atau rasio rebate lebih tinggi; bursa yang memutuskan apa yang diberikan.
Telegram · @feeotter
