USDT無期限契約の注文数量フィールドタイプ変更および機能展開計画に関するGateお知らせ
USDT無期限契約の注文数量フィールドタイプ変更および機能展開計画に関するGateお知らせ
2025-12-18 11:53:58 UTC24,102 表示
先物サイズ関連フィールドタイプの変更について
将来的な取引の柔軟性向上および小数数量注文への完全対応を目的として、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関連フィールド
| インターフェース種別 | エンドポイント | フィールド | 備考 |
|---|---|---|---|
| パブリック | 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. クライアント側で受け入れ型の調整が必要です。 |
| パブリック | 1. 先物市場デプス情報の取得 GET /futures/settle/order_book |
サイズ 's' |
|
| パブリック | 1. 先物市場取引履歴 GET /futures/settle/trades |
取引数量 'size' | |
| パブリック | 1. 先物市場K線チャート GET /futures/settle/candlesticks |
サイズ（先物サイズ） 'v' |
|
| パブリック | 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' |
|
| パブリック | 1. 清算注文履歴の取得 GET /futures/settle/liq_orders |
ポジションサイズ 'size' 清算注文価格 'order_size' システム清算注文メイカー数量 'left' |
|
| プライベート | 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' |
|
| プライベート | 1. 先物注文の発注 POST /futures/settle/orders 2. 先物注文リストの取得 GET /futures/settle/orders 3. 'open'ステータスの全注文キャンセル DELETE /futures/settle/orders 4. 時間範囲指定での注文リスト取得 GET /futures/settle/orders_timerange 5. バッチ先物注文の発注 POST /futures/settle/batch_orders 6. 単一注文詳細の取得 GET /futures/settle/orders/order_id 7. 単一注文のキャンセル DELETE /futures/settle/orders/order_id 8. 単一注文の修正 PUT /futures/settle/orders/order_id 9. レベル別BBO先物注文発注 POST /futures/settle/bbo_orders |
取引数量 'size' アイスバーグ注文表示数量 'iceberg' 未約定数量 'left' |
|
| プライベート | 1. 個人取引履歴の取得 GET /futures/settle/my_trades 2. 時間範囲指定での個人取引履歴取得 GET /futures/settle/my_trades_timerange |
取引数量 'size' 決済済みポジション数量 'close_size' |
|
| プライベート | 1. ポジション決済履歴の取得 GET /futures/settle/position_close |
最大取引数量 'max_size' 累計決済済みポジション数量 'accum_size' |
|
| プライベート | 1. 清算履歴の取得 GET /futures/settle/liquidates |
ポジションサイズ 'size' 清算注文未約定数量 'left' |
|
| プライベート | 1. ADL自動デレバレッジ注文情報の取得 GET /futures/settle/auto_deleverges |
取引数量 'trade_size' ADL後のポジションサイズ 'position_size' |
|
| プライベート | 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関連フィールド
| チャンネル種別 | チャンネル | フィールド | 備考 |
|---|---|---|---|
| パブリック | 1. パブリック取引チャンネル futures.trades |
約定数量 'size' |
1. ヘッダーフィールド X-Gate-Size-Decimal=1 利用時、上記フィールドの型が Integer から String に変更されます。 2. クライアント側で受け入れ型の調整が必要です。 |
| パブリック | 1. ティッカーチャンネル futures.tickers |
合計数量 'total_size' | |
| パブリック | 1. BBOチャンネル futures.book_ticker |
最良買い数量 'A' 最良売り数量 'B' |
|
| パブリック | 1. デプス更新チャンネル futures.order_book_update |
売り板未約定数量 'a.s' 買い板未約定数量 'b.s' |
|
| パブリック | 1. フルデプスチャンネル futures.order_book |
売り板未約定数量 a.s 買い板未約定数量 b.s |
|
| パブリック | 1. デプスV2チャンネル futures.obu |
[価格,数量] 'size' 小数サイズのプッシュ可能 |
|
| パブリック | 1. K線チャンネル futures.candlesticks |
ボリューム 'v' | |
| パブリック | 1. パブリック清算チャンネル futures.public_liquidates |
清算注文数量 'size' | |
| パブリック | 1. 先物統計チャンネル futures.contract_stats |
ロング清算数量 'long_liq_size' ショート清算数量 'short_liq_size' 建玉合計 'open_interest' |
|
| プライベート | 1. プライベート注文チャンネル futures.orders |
アイスバーグ注文表示数量 'iceberg' 残り取引可能数量 'left' 注文数量 'size' |
|
| プライベート | 1. プライベート取引チャンネル futures.usertrades |
約定数量 'size' | |
| プライベート | 1. プライベートADLチャンネル futures.auto_deleverages |
ポジションサイズ 'position_size' 取引数量 'trade_size' |
|
| プライベート | 1. ポジションチャンネル futures.positions |
ポジションサイズ 'size' | |
| プライベート | 1. 価格トリガー注文チャンネル futures.autoorders |
新フィールド：'amount'（string型） | 1. 新フィールド： amount （string型）。 2. 既存フィールド size （Integer型）と新フィールド amount （String型）は互換性あり。 |
| プライベート | 1. 清算注文チャンネル futures.liquidates |
残り取引可能数量 'left' ポジションサイズ 'size' |
1. ヘッダーフィールド X-Gate-Size-Decimal=1 利用時、上記フィールドの型が Integer から String に変更されます。 2. クライアント側で受け入れ型の調整が必要です。 |
| プライベート | 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 小数注文対応先物情報の照会方法
- ヘッダーX-Gate-Size-Decimal=1を設定
- 契約情報エンドポイントへリクエスト
curl --location 'https://api.gateio.ws/api/v4/futures/usdt/contracts' \
--header 'X-Gate-Size-Decimal: 1'- レスポンスフィールドorder_size_minの値が小数の場合、該当先物は小数注文に対応しています。
1.5 その他情報
APIアップデートログ：https://www.gate.com/ja/docs/developers/apiv4/en/#changelog
ご不明点はAPIテクニカルサポートまでお問い合わせいただくか、APIドキュメントをご参照ください。ご理解とご協力を賜り、誠にありがとうございます。
投稿を共有
Gateに登録
登録して10,000 USDT以上の報酬を獲得しよう
口座開設
ログイン