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.
| Parameter Header |
Deskripsi |
Keterangan |
| 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 - Dipotong ke bawah (menuju nol). |
- 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
-
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.
-
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.
-
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
- Semua pasangan perdagangan kontrak akan sepenuhnya mendukung penempatan order lot pecahan.
- 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.
- Setelah masa transisi, field header X-Gate-Size-Decimal akan resmi dihentikan dan konfigurasinya tidak lagi berlaku.
- Semua field terkait jumlah order akan secara seragam menggunakan tipe String untuk memastikan presisi dan kompatibilitas. Tipe Integer lama tidak lagi didukung.
- Tanggal efektif spesifik akan diumumkan sebelumnya melalui pemberitahuan resmi. Pastikan seluruh adaptasi telah selesai sebelumnya.
1.2 Penjelasan Detail Tahap 1 Pembaruan
- Baik REST maupun WebSocket API telah memperkenalkan field header baru, X-Gate-Size-Decimal, untuk mengontrol presisi pada field terkait jumlah.
| Parameter Header |
Deskripsi |
Keterangan |
| 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 - Dipotong ke bawah (menuju nol). |
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.
- 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
| Jenis Channel |
Channel |
Field |
Keterangan |
| 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-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 Depth V2
futures.obu |
[harga,ukuran] 'size' Dapat 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 Sisa yang Dapat 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 Order Pemicu 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 Sisa yang Dapat 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-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 by 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 Sisa yang Dapat Diperdagangkan 'left' Jumlah Tampilan Iceberg 'iceberg' |
|
1.4 Query Informasi Futures yang Mendukung Penempatan Order Desimal
- Atur Header X-Gate-Size-Decimal=1
- Request endpoint Informasi Kontrak
curl --location 'https://api.gateio.ws/api/v4/futures/usdt/contracts' \
--header 'X-Gate-Size-Decimal: 1'
- 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
Tim Gate
18 Desember 2025
**Gerbang Menuju Kripto**
Perdagangkan lebih dari 4,500 mata uang kripto dengan aman, cepat, dan mudah di Gate
**Ambil Tindakan Sekarang**
Daftar dan klaim hadiah sambutan hingga $10.000
Undang teman dan dapatkan komisi 40%
**Tetap Terhubung**
Kunjungi situs resmi Gate
Unduh Aplikasi Gate | Desktop
Ikuti kami di X (Twitter) untuk mendapatkan lebih banyak bonus
Bergabung dengan komunitas Telegram kami untuk berdiskusi topik tren
Berinteraksi dengan komunitas global untuk wawasan terbaru
**Transparansi & Keamanan**
Periksa Proof of Reserves 100% kami
