USDT無期限契約の注文数量欄タイプ変更および機能展開計画に関するGateお知らせ

先物サイズ関連フィールドタイプの変更について
今後の先物取引の柔軟性向上と、少数数量注文への完全対応を目的として、GateはUSDT無期限先物APIの段階的アップグレードを実施します。本アップグレードは、注文数量（サイズ）関連フィールドのパースロジックに影響し、REST APIおよびWebSocketの両方が対象となります。フェーズごとの計画に従い、事前に戦略ロジックの評価および調整を行い、取引への影響がないようご準備ください。

1.1 アップグレード計画概要（3フェーズに分割）

1. フェーズ1：フィールドタイプ互換性アップグレード（2025年12月9日実施）

基盤データ構造の調整が完了しました。
先物数量関連フィールドのデータ型をIntegerからStringへ変更しました。
現在、システムは互換モードで稼働しています。リクエストヘッダーにX-Gate-Size-Decimalフィールドを含めることで、先物ロット数量フィールドの互換処理が可能となります。

ヘッダーパラメータ	説明	備考
X-Gate-Size-Decimal = 1	サイズ関連フィールドタイプがIntegerからStringに変更	1. 小数点データの受信に対応。
X-Gate-Size-Decimal = 0 または本ヘッダーフィールド未使用（デフォルトは未使用）	サイズ関連フィールドタイプはIntegerのまま	1. 小数点データの受信は非対応。 2. 精度処理 - ゼロ方向（切り捨て）で丸め。

X-Gate-Size-Decimalヘッダーが未設定の場合、サイズフィールドはデフォルトでInteger型の受け入れ・返却を継続します。

2. フェーズ2：少数数量注文機能の提供開始

USDT無期限先物における少数ロット注文機能は、2025年12月30日にシステム機能・APIサポートのみ先行公開予定です。本フェーズでは実際の先物で少数ロット注文が可能となるわけではなく、ユーザーの注文ルールも現状維持となります。
2026年1月下旬以降、少数ロット注文機能を対象先物へ段階的に展開します。具体的な対象先物および展開スケジュールは、今後の公式通知でご案内します。
旧フィールドタイプを使用し続けている場合、以下の問題が発生する可能性があります：

先物デプスデータの精度パース異常
注文精度の不一致
約定注文の精度異常

そのため、全API利用者の皆様は、2026年1月末までにフィールドタイプの適応を完了していただくようお願いいたします。

3. フェーズ3：全USDT建て無期限先物への完全対応およびString型フィールドへの強制移行

すべての先物取引ペアで少数ロット注文が完全対応となります。
指定日時において、システムはデフォルトでString型を返却し、ヘッダー（X-Gate-Size-Decimal）のデフォルト値を0から1に変更、未適応ユーザー向けの短期間の移行期間を設けます。
移行期間終了後、X-Gate-Size-Decimalヘッダーフィールドは正式に廃止され、設定は無効となります。
全注文数量関連フィールドは一律でString型となり、精度および互換性を確保します。旧Integer型はサポートされなくなります。
具体的な適用日は事前に公式通知にてご案内いたしますので、必ず事前に適応を完了してください。

1.2 フェーズ1アップグレード詳細説明

1.RESTおよびWebSocket APIの両方で、新しいヘッダーフィールドX-Gate-Size-Decimalが導入され、数量関連フィールドの精度制御が可能となります。

ヘッダーパラメータ	説明	備考
X-Gate-Size-Decimal = 1	サイズ関連フィールドタイプがIntegerからStringに変更	1. 小数点データの受信に対応。
X-Gate-Size-Decimal = 0 または本ヘッダーフィールド未使用（デフォルトは未使用）	サイズ関連フィールドタイプはIntegerのまま	1. 小数点データの受信は非対応。 2. 精度処理 - ゼロ方向（切り捨て）で丸め。

推奨：クライアントは先物数量フィールドタイプの変更へ速やかに適応してください。先物が少数数量注文を正式にサポートした際、迅速に機能を体験・活用できます。

2.ヘッダー設定の参考例

Rest

# リクエストヘッダーの設定 
headers = 
{ 
'KEY': API_KEY,
'Timestamp': timestamp,
'SIGN': signature,
# 小数サイズ有効化
'X-Gate-Size-Decimal': '1',
'Content-Type': 'application/json',
'Accept': 'application/json'
}

Websocket

# リクエストヘッダーの設定
# 小数サイズ有効化
headers['X-Gate-Size-Decimal'] = '1'

1.3 今後のサイズフィールドタイプ変更

1. Rest関連フィールド

インターフェースタイプ	エンドポイント	フィールド	備考
Public	1. 全先物情報の取得 GET /futures/settle/contracts 2. 単一先物情報の取得 GET /futures/settle/contracts/contract	先物で許可される最小注文サイズ 'order_size_min' 先物で許可される最大注文サイズ 'order_size_max' 過去累積取引高 'trade_size' 現在の合計ロングポジションサイズ 'position_size'	1. ヘッダーフィールド X-Gate-Size-Decimal=1 利用時、上記フィールドの型が Integer から String に変更。 2. クライアント側で受け入れ型の調整が必要。
Public	1. 先物市場デプス情報の取得 GET /futures/settle/order_book	サイズ 's'
Public	1. 先物市場取引履歴 GET /futures/settle/trades	取引サイズ 'size'
Public	1. 先物市場K線チャート GET /futures/settle/candlesticks	サイズ取引高（先物サイズ） 'v'
Public	1. 先物統計情報 GET /futures/settle/contract_stats	ロング清算サイズ（先物） 'long_liq_size' ショート清算サイズ（先物） 'short_liq_size' 建玉合計サイズ（先物） 'open_interest' トップトレーダーロング/ショートポジション比率 'top_lsr_size' トップトレーダーロングサイズ 'top_long_size' トップトレーダーショートサイズ 'top_short_size' トップテイカーロングサイズ 'long_taker_size' トップテイカーショートサイズ 'short_taker_size'
Public	1. 清算注文履歴の取得 GET /futures/settle/liq_orders	ポジションサイズ 'size' 清算注文価格 'order_size' システム清算注文メイカーサイズ 'left'
Private	1. ユーザーポジションリスト取得 GET /futures/settle/positions 2. 単一ポジション情報取得 GET /futures/settle/positions/contract 3. ポジション証拠金更新 POST /futures/settle/positions/contract/margin 4. ポジションレバレッジ更新 POST /futures/settle/positions/contract/leverage 5. ポジション証拠金モード切替 POST /futures/settle/positions/cross_mode 6. ヘッジモード下でのクロス/分離証拠金モード切替 POST /futures/settle/dual_comp/positions/cross_mode 7. ポジションリスク限度額更新 POST /futures/settle/positions/contract/risk_limit 8. ポジションモード設定 POST /futures/settle/dual_mode 9. ヘッジモードでのポジション情報取得 GET /futures/settle/dual_comp/positions/contract 10. ヘッジモードでのポジション証拠金更新 POST /futures/settle/dual_comp/positions/contract/margin 11. ヘッジモードでのポジションレバレッジ更新 POST /futures/settle/dual_comp/positions/contract/leverage 12. ヘッジモードでのポジションリスク限度額更新 POST /futures/settle/dual_comp/positions/contract/risk_limit	ポジションサイズ 'size'
Private	1. 先物注文発注 POST /futures/settle/orders 2. 先物注文リスト取得 GET /futures/settle/orders 1. 'open'ステータスの全注文キャンセル DELETE /futures/settle/orders 2. 時間範囲で先物注文リスト取得 GET /futures/settle/orders_timerange 3. バッチ先物注文発注 POST /futures/settle/batch_orders 4. 単一注文詳細取得 GET /futures/settle/orders/order_id 5. 単一注文キャンセル DELETE /futures/settle/orders/order_id 6. 単一注文修正 PUT /futures/settle/orders/order_id 7. レベル別BBO先物注文発注 POST /futures/settle/bbo_orders	取引数量 'size' アイスバーグ注文表示サイズ 'iceberg' 未約定数量 'left'
Private	1. 個人取引履歴取得 GET /futures/settle/my_trades 2. 時間範囲で個人取引履歴取得 GET /futures/settle/my_trades_timerange	取引サイズ 'size' 決済済みポジションサイズ: 'close_size'
Private	1. ポジション決済履歴取得 GET /futures/settle/position_close	最大取引サイズ 'max_size' 累積決済ポジション取引高 'accum_size'
Private	1. 清算履歴取得 GET /futures/settle/liquidates	ポジションサイズ 'size' 清算注文未約定サイズ 'left'
Private	1. ADL自動デレバレッジ注文情報取得 GET /futures/settle/auto_deleverages	取引サイズ 'trade_size' ADL後のポジションサイズ 'position_size'
Private	1. 自動注文リスト取得 GET /futures/settle/price_orders 2. 全自動注文キャンセル DELETE /futures/settle/price_orders 3. 単一自動注文詳細取得 GET /futures/settle/price_orders/order_id 4. 単一自動注文キャンセル DELETE /futures/settle/price_orders/order_id 5. 単一自動注文修正 PUT /futures/settle/price_orders/order_id	新フィールド: 'amount'（string型）	1. 新フィールド: amount (string型) 2. 旧フィールド size (int型)と新フィールド amount (string型)は互換性あり。

2. Websocket関連フィールド

チャンネルタイプ	チャンネル	フィールド	備考
Public	1. パブリック取引チャンネル futures.trades	約定サイズ 'size'	1. ヘッダーフィールド X-Gate-Size-Decimal=1 利用時、上記フィールドの型が Integer から String に変更。 2. クライアント側で受け入れ型の調整が必要。
Public	1. ティッカーチャンネル futures.tickers	合計サイズ 'total_size'
Public	1. BBOチャンネル futures.book_ticker	最良買値サイズ 'A' 最良売値サイズ 'B'
Public	1. デプスアップデートチャンネル futures.order_book_update	売り板未約定サイズ 'a.s' 買い板未約定サイズ 'b.s'
Public	1. フルデプスチャンネル futures.order_book	売り板未約定サイズ a.s 買い板未約定サイズ b.s
Public	1. デプスV2チャンネル futures.obu	[価格,サイズ] 'size' 小数サイズのプッシュあり
Public	1. K線チャンネル futures.candlesticks	取引高 'v'
Public	1. パブリック清算チャンネル futures.public_liquidates	清算注文サイズ 'size'
Public	1. 先物統計チャンネル futures.contract_stats	ロング清算サイズ 'long_liq_size' ショート清算サイズ 'short_liq_size' 建玉合計 'open_interest'
Private	1. プライベート注文チャンネル futures.orders	アイスバーグ表示サイズ 'iceberg' 残取引可能サイズ 'left' 注文サイズ 'size'
Private	1. プライベート取引チャンネル futures.usertrades	約定サイズ 'size'
Private	1. プライベートADLチャンネル futures.auto_deleverages	ポジションサイズ 'position_size' 取引サイズ 'trade_size'
Private	1. ポジションチャンネル futures.positions	ポジションサイズ 'size'
Private	1. 価格トリガー注文チャンネル futures.autoorders	新フィールド: 'amount'（string型）	1. 新フィールド: amount (string型) 2. 旧フィールド size ( Integer型)と新フィールド amount (String型)は互換性あり。
Private	1. 清算注文チャンネル futures.liquidates	残取引可能サイズ 'left' ポジションサイズ 'size'	1. ヘッダーフィールド X-Gate-Size-Decimal=1 利用時、上記フィールドの型が Integer から String に変更。 2. クライアント側で受け入れ型の調整が必要。
Private	1. 注文発注 futures.order_place 2. バッチ注文発注 futures.order_batch_place 3. 注文キャンセル futures.order_cancel 4. ID指定バッチキャンセル futures.order_cancel_cp 5. 注文修正 futures.order_amend 6. 注文リスト取得 futures.order_list 7. 注文詳細取得 futures.order_status	注文サイズ 'size' 残取引可能サイズ 'left' アイスバーグ表示数量 'iceberg'

1.4 小数注文対応先物情報の取得方法

1.ヘッダー X-Gate-Size-Decimal=1 を設定
2.契約情報エンドポイントへリクエスト

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

3.返却フィールド order_size_min：値が小数の場合、該当先物が小数注文に対応していることを示します。

1.5 追加情報

APIアップデートログ: https://www.gate.com/ja/docs/developers/apiv4/en/#changelog
ご不明点はAPI技術サポートまでお問い合わせいただくか、APIドキュメントをご参照ください。ご支援とご理解に感謝いたします。

Gateチーム 2025年12月18日 **Gateway to Crypto** Gateで4,400種類以上の暗号資産を安全・迅速・簡単に取引 **今すぐ始めよう** 登録して最大$10,000のウェルカム報酬を獲得友達を招待して最大40%のコミッションを獲得 **最新情報をチェック** Gate公式サイトを訪問 Gateアプリをダウンロード｜デスクトップ X（Twitter）でフォローしてさらにボーナス獲得 Telegramコミュニティ参加でトレンドを議論グローバルコミュニティで交流し最新情報を入手 **透明性とセキュリティ** 100%資産証明を確認