Gate 关于 USDT 永续合约下单张数字段类型变更与功能上线计划公告

大门交易平台 USDT 永续合约下单支持小数--字段类型变动说明 为提升合约交易灵活性并全面支持小数张数下单，大门交易平台 将对 USDT 永续合约相关接口进行分阶段升级。本次升级将影响 REST API 与 WebSocket 中与订单张数（size）相关的字段解析逻辑。请您根据阶段计划提前评估与调整策略逻辑，确保您的交易不受影响。

1.1 升级计划说明 （整体分为 3 个阶段）

1. 阶段1: 字段类型兼容性升级 ( 2025-12-09 已上线)：

• 已经完成底层数据结构调整。
• 合约张数相关字段类型有原来的 Integer 升级为 String 类型。

• 当前处于兼容模中，通过在请求Header 中传入 X-大门交易平台-Size-Decimal字段，以实现合约张数字段兼容处理。

• 设置方式如下：

• 如果不设置 header（ X-大门交易平台-Size-Decimal ）字段，默认情况下，size 字段接收和响应依然返回 Integer 类型。

2. 阶段2：小数张数下单能力上线

1. 计划于 2025 年 12 月 30 日上线 USDT 永续合约小数张数下单的系统能力，该阶段仅完成底层能力和接口支持，暂不开放任何合约市场实际支持小数张数下单，用户实际下单规则保持不变。
2. 自 2026 年 1 月底起，将逐步开放合约市场支持小数张数下单功能，具体开放市场及时间以平台后续公告为准。
3. 在合约市场开放小数张数下单功能后，仍使用旧字段类型且未适配的用户，将可能出现：
   • 市场深度的精度解析异常
   • 下单精度不一致
   • 成交订单精度异常

因此提醒所有 API 用户尽量在 2026 年 1 月底之前完成字段类型适配

3. 阶段 3 ：全面市场支持 + 字段全面切换为 String 类型

• 将全面开放所有合约交易对小数张数下单能力。
• 将在某固定时间，系统默认返回 String 类型，并且调整 header （ X-大门交易平台-Size-Decimal ）的默认值， 默认解析行为从 0 切换为 1 ，为仍未完成适配的用户提供短暂的过渡期。
• 过渡期结束后，正式废弃 X-大门交易平台-Size-Decimal header 请求头字段，其配置不再生效。
• 所有与订单张数相关的字段将统一使用 String 类型。 为确保精度与兼容性，旧类型 Integer 将不在支持。
• 具体生效时间将提前通过官方公告通知，请务必提前完成适配。

1.2 阶段 1 升级详细说明

1.Rest 和 Websocket 新增 header 字段 X-大门交易平台-Size-Decimal 控制张数相关字段精度

建议：客户端及时调整合约张数字段类型变更，待合约支持下单小数交易功能正式上线，可以快速体验和使用该功能。

2.设置 header 参考示例

Rest

# 设置请求头
headers = 
{ 
'KEY': API_KEY, 
'Timestamp': timestamp,
'SIGN': signature, 
**'X-大门交易平台-Size-Decimal': '1', # 启用小数张数 
'Content-Type': 'application/json', 
'Accept': 'application/json'
}

Websocket

# 设置请求头 
# 启用小数张数
headers['X-大门交易平台-Size-Decimal'] = '1'

1.3 合约张数字段类型变更接口（请详细对比）

1. Rest 相关字段

2. Websocket 相关字段

1.4 查询支持小数下单的合约信息

1. 设置 header ：X-大门交易平台-Size-Decimal=1

2. 请求合约信息接口

   curl --location 'https://api.大门交易平台io.ws/api/v4/futures/usdt/contracts' \ 
   --header 'X-大门交易平台-Size-Decimal: 1'

3. 返回字段 order_size_min 如果是小数，即表示该合约支持小数张数下单交易。

1.5 更多说明

API更新日志：https://www.大门交易平台.com/docs/developers/apiv4/zh_CN/#changelog 如有疑问，请联系API技术支持或参考API文档。感谢您的支持与理解。