Pengumuman Pengumuman Gate tentang Perubahan Jenis Kolom Jumlah Order pada Kontrak Perpetual USDT dan Rencana Peluncuran Fitur

Pengumuman Gate tentang Perubahan Jenis Kolom Jumlah Order pada Kontrak Perpetual USDT dan Rencana Peluncuran Fitur

2025-12-18 11:53:58 UTC 25098 Baca

[//]:content-type-MARKDOWN-DONOT-DELETE
**Perubahan pada Jenis Field Terkait Ukuran Futures**
Untuk meningkatkan fleksibilitas perdagangan futures dan sepenuhnya mendukung order dengan jumlah pecahan, Gate akan menerapkan pembaruan bertahap pada API kontrak perpetual USDT. Pembaruan ini akan memengaruhi logika parsing pada field terkait jumlah order (ukuran) di REST API dan WebSocket. Silakan evaluasi dan sesuaikan logika strategi Anda sebelumnya sesuai dengan rencana bertahap agar perdagangan Anda tetap berjalan lancar.

### 1.1 Ikhtisar Rencana Pembaruan (Dibagi dalam 3 Tahap)

**1. Tahap 1: Pembaruan 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, proses kompatibilitas untuk field jumlah lot kontrak dapat dilakukan.

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

**2. Tahap 2: Peluncuran Kemampuan Order Jumlah Pecahan**

1. Kemampuan sistem untuk order lot pecahan pada kontrak perpetual USDT dijadwalkan akan 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 pecahan saat ini, dan aturan penempatan order aktual untuk pengguna tetap tidak berubah.

2. Mulai akhir Januari 2026, fungsi order lot pecahan akan secara bertahap diterapkan pada kontrak. Kontrak dan waktu peluncuran spesifik 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 sebanyak mungkin sebelum akhir Januari 2026.***

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

1. Semua pasangan perdagangan kontrak akan sepenuhnya mendukung penempatan order lot pecahan.
2. Pada waktu yang ditentukan, sistem akan default mengembalikan tipe String dan menyesuaikan nilai default pada header (X-Gate-Size-Decimal), mengubah perilaku parsing default dari 0 menjadi 1 untuk memberikan masa transisi singkat bagi pengguna yang belum menyelesaikan adaptasi.
3. Setelah masa transisi, field header X-Gate-Size-Decimal akan resmi dihentikan dan konfigurasinya 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 sebelumnya melalui pemberitahuan resmi. Pastikan seluruh adaptasi telah selesai sebelumnya.

### 1.2 Penjelasan Detail Tahap 1 Pembaruan

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

Rekomendasi: Klien sebaiknya segera melakukan adaptasi terhadap perubahan jenis field jumlah kontrak. Setelah kontrak resmi mendukung order jumlah pecahan, klien dapat langsung mencoba dan memanfaatkan fungsi ini.

2. Contoh Referensi Pengaturan Header

Rest

```
# Pengaturan 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

```
# Pengaturan 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 | Keterangan |
| :--- | :--- | :--- | :--- |
| 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 kontrak 'order_size_min' Ukuran order maksimum yang diizinkan 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-field tersebut. |
| Publik | 1. Query informasi 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' Ukuran total open interest (kontrak) 'open_interest' Rasio posisi long/short trader teratas 'top_lsr_size' Ukuran posisi long trader teratas 'top_long_size' Ukuran posisi short trader teratas 'top_short_size' Ukuran posisi long taker teratas 'long_taker_size' Ukuran posisi 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 informasi posisi tunggal GET /futures/settle/positions/contract 3. Ubah margin posisi POST /futures/settle/positions/contract/margin 4. Ubah leverage posisi POST /futures/settle/positions/contract/leverage 5. Ubah Mode Margin Posisi POST /futures/settle/positions/cross_mode 6. Beralih antara Mode Margin Cross dan Isolated di Mode Hedge POST /futures/settle/dual_comp/positions/cross_mode 7. Ubah batas risiko posisi POST /futures/settle/positions/contract/risk_limit 8. Atur mode posisi POST /futures/settle/dual_mode 9. Dapatkan informasi posisi di Mode Hedge GET /futures/settle/dual_comp/positions/contract 10. Ubah margin posisi di Mode Hedge POST /futures/settle/dual_comp/positions/contract/margin 11. Ubah leverage posisi di Mode Hedge POST /futures/settle/dual_comp/positions/contract/leverage 12. Ubah batas risiko posisi di Mode Hedge POST /futures/settle/dual_comp/positions/contract/risk_limit | Ukuran Posisi 'size' | |
| Privat | 1. Tempatkan order futures POST /futures/settle/orders 2. Query daftar order futures GET /futures/settle/orders 3. Batalkan semua order dengan status 'open' DELETE /futures/settle/orders 4. Query daftar order futures berdasarkan rentang waktu GET /futures/settle/orders_timerange 5. Tempatkan batch order futures POST /futures/settle/batch_orders 6. Query detail order tunggal GET /futures/settle/orders/order_id 7. Batalkan order tunggal DELETE /futures/settle/orders/order_id 8. Ubah order tunggal PUT /futures/settle/orders/order_id 9. Penempatan Order Kontrak BBO Berbasis Level POST /futures/settle/bbo_orders | Jumlah perdagangan. 'size' Ukuran tampilan iceberg order 'iceberg' Jumlah yang belum terisi 'left' | |
| Privat | 1. Query catatan perdagangan pribadi GET /futures/settle/my_trades 2. Query catatan perdagangan pribadi berdasarkan rentang waktu GET /futures/settle/my_trades_timerange | Ukuran Perdagangan 'size' Ukuran posisi tertutup: '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 Pending Order Likuidasi 'left' | |
| Privat | 1. Query informasi order auto-deleveraging ADL GET /futures/settle/auto_deleverages | Ukuran Perdagangan 'trade_size' Ukuran Posisi Setelah ADL 'position_size' | |
| Privat | 1. Query daftar order otomatis GET /futures/settle/price_orders 2. Batalkan semua order otomatis DELETE /futures/settle/price_orders 3. Query detail order otomatis tunggal GET /futures/settle/price_orders/order_id 4. Batalkan order otomatis tunggal DELETE /futures/settle/price_orders/order_id 5. Ubah Order Otomatis 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**

### 1.4 Query Informasi Futures yang Mendukung Penempatan Order 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 order_size_min yang dikembalikan: Jika nilainya berupa desimal, maka futures terkait mendukung penempatan order 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 lihat dokumentasi API. Terima kasih atas dukungan dan pengertian Anda

<sp>
Tim Gate
18 Desember 2025
<sp>
**Gerbang Menuju Kripto**
Perdagangkan lebih dari %Amount_of_Currency% mata uang kripto dengan aman, cepat, dan mudah di Gate
**Ambil Tindakan Sekarang**
<a href="https://www.gate.com/id/signup" target="_blank">Daftar</a> dan klaim hadiah sambutan hingga $10.000
<a href="https://www.gate.com/id/referral" target="_blank">Undang teman</a> dan dapatkan komisi 40%
**Tetap Terhubung**
<a href="https://www.gate.com/id/" target="_blank">Kunjungi situs resmi Gate</a>
<a href="https://www.gate.com/id/mobileapp?ch=ann48788" target="_blank">Unduh Aplikasi Gate | Desktop</a>
<a href="https://x.com/Gate" rel="nofollow noopener noreferrer" target="_blank">Ikuti kami di X (Twitter)</a> untuk mendapatkan lebih banyak bonus
<a href="https://t.me/GateCom_EN" rel="nofollow noopener noreferrer" target="_blank">Bergabung dengan komunitas Telegram kami</a> untuk berdiskusi topik tren
<a href="https://www.gate.com/id/community" target="_blank">Berinteraksi dengan komunitas global</a> untuk wawasan terbaru
**Transparansi & Keamanan**
<a href="https://www.gate.com/id/proof-of-reserves" target="_blank">Periksa Proof of Reserves 100% kami</a>

Catatan：Teks ini merupakan terjemahan dari teks asli bahasa Inggris oleh mesin atau manusia, sehingga mungkin terdapat ketidakakuratan dalam terjemahannya. Klik di sini untuk melihat teks bahasa Inggris aslinya.

Ubah & Waktu Mulai-Akhir Grafik

Warna Naik/Turun

Pay With

Pengumuman Gate tentang Perubahan Jenis Kolom Jumlah Order pada Kontrak Perpetual USDT dan Rencana Peluncuran Fitur

Pengumuman Gate tentang Perubahan Jenis Kolom Jumlah Order pada Kontrak Perpetual USDT dan Rencana Peluncuran Fitur

Pilih bahasa dan wilayah

Pilih wilayah Anda

Mata Uang Fiat