Pengumuman Gate mengenai Ubah Jenis Kolom Jumlah Order pada Kontrak Perp USDT dan Rencana Peluncuran Fitur

Perubahan pada Jenis Field Terkait Ukuran Futures
Untuk meningkatkan fleksibilitas perdagangan futures dan mendukung sepenuhnya order dengan jumlah fraksional, Gate akan menerapkan peningkatan bertahap pada API kontrak perpetual USDT. Peningkatan ini akan memengaruhi logika parsing pada field terkait jumlah order (ukuran) di REST API dan WebSocket. Silakan evaluasi dan sesuaikan logika strategi Anda terlebih dahulu sesuai dengan rencana bertahap agar aktivitas perdagangan Anda tetap berjalan lancar.

1.1 Ikhtisar Rencana Peningkatan (Terbagi dalam 3 Tahap)

1. Tahap 1: Peningkatan Kompatibilitas Jenis Field (Diluncurkan pada 9 Desember 2025)

• Penyesuaian struktur data dasar telah selesai.
• Jenis data pada field terkait jumlah kontrak diubah dari Integer menjadi String.
• Sistem saat ini berada dalam mode kompatibilitas. Dengan menyertakan field X-Gate-Size-Decimal pada header permintaan, pemrosesan kompatibilitas untuk field jumlah lot kontrak dapat dilakukan.

Parameter Header	Deskripsi	Catatan
X-Gate-Size-Decimal = 1	jenis field terkait ukuran berubah dari Integer menjadi String	1. Mendukung penerimaan data desimal.
X-Gate-Size-Decimal = 0 Atau tidak menggunakan field header ini Secara default, field ini tidak digunakan.	jenis field terkait ukuran tetap Integer	1. Tidak mendukung penerimaan data desimal. 2. Penanganan presisi - Membulatkan ke bawah (truncates towards zero).

• Jika header X-Gate-Size-Decimal tidak diatur, field size akan tetap menerima dan mengembalikan tipe Integer secara default.

2. Tahap 2: Peluncuran Kemampuan Order dengan Jumlah Fraksional

1. Kemampuan sistem untuk order lot fraksional pada kontrak perpetual USDT dijadwalkan diluncurkan pada 30 Desember 2025. Pada tahap ini, hanya kemampuan sistem dasar dan dukungan API yang akan diaktifkan. Tidak ada kontrak yang benar-benar dibuka untuk order lot fraksional pada saat ini, dan aturan order aktual untuk pengguna tetap tidak berubah.

2. Mulai akhir Januari 2026, fitur order lot fraksional akan secara bertahap diterapkan pada kontrak. Kontrak spesifik dan jadwal penerapan akan diumumkan oleh platform melalui pemberitahuan selanjutnya.

3. Untuk pengguna yang masih menggunakan jenis field lama tanpa adaptasi, masalah berikut dapat terjadi:

• Parsing presisi abnormal pada data kedalaman kontrak.
• Presisi order yang tidak konsisten.
• Presisi abnormal pada order yang telah terisi.

Oleh karena itu, seluruh pengguna API diingatkan untuk menyelesaikan adaptasi jenis field sebelum akhir Januari 2026 sebanyak mungkin.

3. Tahap 3: Aktivasi Penuh untuk Semua Kontrak Perpetual USDT-M dan Migrasi Wajib ke Jenis Field String

1. Semua pasangan perdagangan kontrak akan sepenuhnya mendukung order lot fraksional.
2. Pada waktu yang ditentukan, sistem akan default mengembalikan tipe String dan mengubah nilai default pada header (X-Gate-Size-Decimal), mengalihkan perilaku parsing default dari 0 ke 1 untuk memberikan periode transisi singkat bagi pengguna yang belum menyelesaikan adaptasi.
3. Setelah periode transisi berakhir, field header X-Gate-Size-Decimal akan resmi dihapus, dan konfigurasi tersebut tidak lagi berlaku.
4. Semua field terkait jumlah order akan secara seragam menggunakan tipe String untuk memastikan presisi dan kompatibilitas. Tipe Integer lama tidak lagi didukung.
5. Tanggal efektif spesifik akan diumumkan terlebih dahulu melalui pemberitahuan resmi. Pastikan seluruh adaptasi telah dilakukan sebelumnya.

1.2 Penjelasan Detail Peningkatan Tahap 1

1. Baik REST maupun WebSocket API telah menambahkan field header baru, X-Gate-Size-Decimal, untuk mengontrol presisi pada field terkait jumlah.

Parameter Header	Deskripsi	Catatan
X-Gate-Size-Decimal = 1	jenis field terkait ukuran berubah dari Integer menjadi String	1. Mendukung penerimaan data desimal.
X-Gate-Size-Decimal = 0 Atau tidak menggunakan field header ini Secara default, field ini tidak digunakan.	jenis field terkait ukuran tetap Integer	1. Tidak mendukung penerimaan data desimal. 2. Penanganan presisi - Membulatkan ke bawah (truncates towards zero).

Rekomendasi: Klien disarankan segera mengadaptasi perubahan pada jenis field jumlah kontrak. Setelah kontrak resmi mendukung order dengan jumlah fraksional, Anda dapat langsung memanfaatkan fitur ini.

2. Contoh Referensi Pengaturan Header

Rest

# Atur header permintaan 
headers = 
{ 
'KEY': API_KEY,
'Timestamp': timestamp,
'SIGN': signature,
# Aktifkan ukuran desimal
'X-Gate-Size-Decimal': '1',
'Content-Type': 'application/json',
'Accept': 'application/json'
}

Websocket

# Atur header permintaan
# Aktifkan ukuran desimal
headers['X-Gate-Size-Decimal'] = '1'

1.3 Perubahan Jenis Field Ukuran Futures Mendatang

1. Field Terkait Rest

Jenis Interface	Endpoint	Field	Catatan
Publik	1. Query Semua Info Futures GET /futures/settle/contracts 2. Query Info Futures Tunggal GET /futures/settle/contracts/contract	Ukuran order minimum yang diizinkan oleh kontrak 'order_size_min' Ukuran order maksimum yang diizinkan oleh kontrak 'order_size_max' Volume perdagangan kumulatif historis 'trade_size' Ukuran total posisi long saat ini 'position_size'	1. Dengan menggunakan field header X-Gate-Size-Decimal=1 , tipe field di atas akan berubah dari Integer menjadi String . 2. Klien perlu menyesuaikan tipe penerimaan untuk field tersebut.
Publik	1. Query info kedalaman pasar futures GET /futures/settle/order_book	Ukuran 's'
Publik	1. Catatan transaksi pasar futures GET /futures/settle/trades	Ukuran Perdagangan 'size'
Publik	1. Grafik K-line pasar futures GET /futures/settle/candlesticks	volume ukuran (ukuran kontrak) 'v'
Publik	1. Statistik futures GET /futures/settle/contract_stats	Ukuran likuidasi long (kontrak) 'long_liq_size' Ukuran likuidasi short (kontrak) 'short_liq_size' Total open interest (kontrak) 'open_interest' Rasio posisi long/short trader teratas 'top_lsr_size' Ukuran long trader teratas 'top_long_size' Ukuran short trader teratas 'top_short_size' Ukuran long taker teratas 'long_taker_size' Ukuran short taker teratas 'short_taker_size'
Publik	1. Query riwayat order likuidasi GET /futures/settle/liq_orders	Ukuran posisi 'size' Harga order likuidasi 'order_size' Ukuran maker order likuidasi sistem 'left'
Privat	1. Dapatkan daftar posisi pengguna GET /futures/settle/positions 2. Dapatkan info posisi tunggal GET /futures/settle/positions/contract 3. Perbarui margin posisi POST /futures/settle/positions/contract/margin 4. Perbarui leverage posisi POST /futures/settle/positions/contract/leverage 5. Ubah Mode Margin Posisi POST /futures/settle/positions/cross_mode 6. Beralih antara Mode Cross dan Isolated Margin dalam Mode Hedge POST /futures/settle/dual_comp/positions/cross_mode 7. Perbarui batas risiko posisi POST /futures/settle/positions/contract/risk_limit 8. Atur mode posisi POST /futures/settle/dual_mode 9. Dapatkan info posisi dalam Mode Hedge GET /futures/settle/dual_comp/positions/contract 10. Perbarui margin posisi dalam Mode Hedge POST /futures/settle/dual_comp/positions/contract/margin 11. Perbarui leverage posisi dalam Mode Hedge POST /futures/settle/dual_comp/positions/contract/leverage 12. Perbarui batas risiko posisi dalam Mode Hedge POST /futures/settle/dual_comp/positions/contract/risk_limit	Ukuran Posisi 'size'
Privat	1. Pasang order futures POST /futures/settle/orders 2. Query daftar order futures GET /futures/settle/orders 1. Batalkan semua order dengan status 'open' DELETE /futures/settle/orders 2. Query daftar order futures berdasarkan rentang waktu GET /futures/settle/orders_timerange 3. Pasang batch order futures POST /futures/settle/batch_orders 4. Query detail order tunggal GET /futures/settle/orders/order_id 5. Batalkan order tunggal DELETE /futures/settle/orders/order_id 6. Ubah order tunggal PUT /futures/settle/orders/order_id 7. Penempatan Order Kontrak BBO Berbasis Level POST /futures/settle/bbo_orders	Jumlah perdagangan. 'size' Ukuran tampilan untuk iceberg order 'iceberg' Jumlah belum terisi 'left'
Privat	1. Query riwayat perdagangan pribadi GET /futures/settle/my_trades 2. Query riwayat perdagangan pribadi berdasarkan rentang waktu GET /futures/settle/my_trades_timerange	Ukuran Perdagangan 'size' Ukuran posisi yang ditutup: 'close_size'
Privat	1. Query riwayat penutupan posisi GET /futures/settle/position_close	Ukuran Perdagangan Maksimum 'max_size' Volume posisi tertutup kumulatif 'accum_size'
Privat	1. Query riwayat likuidasi GET /futures/settle/liquidates	Ukuran Posisi 'size' Ukuran order likuidasi yang menunggu 'left'
Privat	1. Query info order ADL auto-deleveraging GET /futures/settle/auto_deleverges	Ukuran Perdagangan 'trade_size' Ukuran Posisi Setelah ADL 'position_size'
Privat	1. Query daftar auto order GET /futures/settle/price_orders 2. Batalkan semua auto order DELETE /futures/settle/price_orders 3. Query detail auto order tunggal GET /futures/settle/price_orders/order_id 4. Batalkan auto order tunggal DELETE /futures/settle/price_orders/order_id 5. Ubah Auto Order Tunggal PUT /futures/settle/price_orders/order_id	Field baru: 'amount' (tipe string).	1. Field baru: amount (tipe string). 2. Field lama size (int ) dan field baru amount (string) akan kompatibel.

2. Field Terkait Websocket

Jenis Channel	Channel	Field	Catatan
Publik	1. Channel Perdagangan Publik futures.trades	Ukuran Terisi 'size'	1. Dengan menggunakan field header X-Gate-Size-Decimal=1 , tipe field di atas akan berubah dari Integer menjadi String . 2. Klien perlu menyesuaikan tipe penerimaan untuk field tersebut.
Publik	1. Channel Ticker futures.tickers	Ukuran Total 'total_size'
Publik	1. Channel BBO futures.book_ticker	Ukuran Bid Terbaik 'A' Ukuran Ask Terbaik 'B'
Publik	1. Channel Pembaruan Kedalaman futures.order_book_update	Ukuran Pending Sisi Ask 'a.s' Ukuran Pending Sisi Bid 'b.s'
Publik	1. Channel Kedalaman Penuh futures.order_book	Ukuran Pending Sisi Ask a.s Ukuran Pending Sisi Bid b.s
Publik	1. Channel Kedalaman V2 futures.obu	[harga,ukuran] 'size' Mungkin mendorong ukuran desimal
Publik	1. Channel Candlestick futures.candlesticks	Volume 'v'
Publik	1. Channel Likuidasi Publik futures.public_liquidates	Ukuran Order Likuidasi 'size'
Publik	1. Channel Statistik Kontrak futures.contract_stats	Ukuran Likuidasi Long 'long_liq_size' Ukuran Likuidasi Short 'short_liq_size' Total Open Interest 'open_interest'
Privat	1. Channel Order Privat futures.orders	Ukuran Tampilan Iceberg 'iceberg' Ukuran Tersisa yang Bisa Diperdagangkan 'left' Ukuran Order 'size'
Privat	1. Channel Perdagangan Privat futures.usertrades	Ukuran Terisi 'size'
Privat	1. Channel ADL Privat futures.auto_deleverages	Ukuran Posisi 'position_size' Ukuran Perdagangan 'trade_size'
Privat	1. Channel Posisi futures.positions	Ukuran Posisi 'size'
Privat	1. Channel Auto Order Trigger Harga futures.autoorders	Field baru: 'amount' (tipe string).	1. Field baru: amount (tipe string). 2. Field lama size ( tipe Integer ) dan field baru amount (String) akan kompatibel.
Privat	1. Channel Order Likuidasi futures.liquidates	Ukuran Tersisa yang Bisa Diperdagangkan 'left' Ukuran Posisi 'size'	1. Dengan menggunakan field header X-Gate-Size-Decimal=1 , tipe field di atas akan berubah dari Integer menjadi String . 2. Klien perlu menyesuaikan tipe penerimaan untuk field tersebut.
Privat	1. Penempatan Order futures.order_place 2. Penempatan Batch Order futures.order_batch_place 3. Pembatalan Order futures.order_cancel 4. Batch Cancel berdasarkan ID futures.order_cancel_cp 5. Perubahan Order futures.order_amend 6. Query Daftar Order futures.order_list 7. Query Detail Order futures.order_status	Ukuran Order 'size' Ukuran Tersisa yang Bisa Diperdagangkan 'left' Kuantitas Tampilan Iceberg 'iceberg'

1.4 Query Informasi Futures yang Mendukung Order dengan Ukuran Desimal

1. Atur Header X-Gate-Size-Decimal=1
2. Request endpoint Informasi Kontrak

curl --location 'https://api.gateio.ws/api/v4/futures/usdt/contracts' \ 
--header 'X-Gate-Size-Decimal: 1'

3. Field balikan order_size_min: Jika nilainya desimal, maka kontrak futures terkait mendukung order dengan ukuran desimal.

1.5 Informasi Tambahan

Log Pembaruan API: https://www.gate.com/id/docs/developers/apiv4/en/#changelog
Untuk pertanyaan lebih lanjut, silakan hubungi dukungan teknis API atau merujuk pada dokumentasi API. Terima kasih atas dukungan dan pengertian Anda

Tim Gate 18 Desember 2025 **Gateway ke Kripto** Perdagangkan lebih dari 4,400 aset kripto secara aman, cepat, dan mudah di Gate **Ambil Tindakan Sekarang** Daftar dan klaim hingga $10.000 hadiah sambutan Undang teman dan dapatkan komisi 40% **Tetap Terhubung** Kunjungi situs resmi Gate Unduh Gate App | Desktop Ikuti kami di X (Twitter) untuk mendapatkan lebih banyak bonus Bergabung dengan komunitas Telegram kami untuk berdiskusi topik terkini Berinteraksi dengan komunitas global kami untuk wawasan terbaru **Transparansi & Keamanan** Periksa 100% Proof of Reserves kami