[//]:content-type-MARKDOWN-DONOT-DELETE **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,100 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

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

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