接口文档研读 · 永续合约

独立教程与工具 · 非 Gate 官方网站

API REFERENCE / 永续合约

Gate 单个永续跟踪订单的生命周期：参数、响应与查询工具

按任务编号读取永续跟踪订单详情，定位激活时间、极值价格、触发价与关联子订单。

需要官方 API 鉴权固定规格 v4.106.132资料核对：2026-09-10
GET /futures/{settle}/autoorder/v1/trail/detail

这条查询解决什么问题

本接口以 code、message、data 包装结果，应先判断业务状态，再把创建、激活和结束时间作为不同事件解释。

这是账户数据查询文档。真实调用需要在你自己的可信环境完成官方鉴权；此页没有登录、密钥输入或账户连接功能。

查看官方英文说明

Get trail order details

此操作没有额外说明。

请求参数逐项核对

字段名和数据类型保留官方拼写。必填标记来自规格；描述中的条件约束还需要一起检查。

参数与位置类型与范围官方字段说明
settlepath · 必填string枚举：btc / usdt / usd1
Perpetual futures settlement currency
idquery · 必填integer格式："int64"
Order ID

在本页组装查询 URL

填写参数后生成一个 GET 地址，只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。

path · string枚举：btc / usdt / usd1
query · integer格式："int64"
尚未生成 URL。

不会向 Gate 或本站发送表单内容。

工具检查必填、枚举与简单数值范围，不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。

响应字段怎样阅读

以下展示的是规格中的类型定义，不是现场 API 响应，也不是行情样本。嵌套结构展开至三层；数组的 [] 表示其中一个元素。

HTTP 200 · Query successful

字段路径数据类型字段说明
$object
未提供字段注释
$.codeinteger格式："int32"
Status code, 0 means success
$.messagestring
Response message
$.dataobject
未提供字段注释
$.data.orderobject
Trail order details
$.data.order.idinteger格式："int64"
Order ID
$.data.order.user_idinteger格式："int64"
User ID
$.data.order.userinteger格式："int64"
User ID
$.data.order.contractstring
Contract name
$.data.order.settlestring
Settle currency
$.data.order.amountstring
Trading quantity in contracts, positive for buy, negative for sell
$.data.order.is_gteboolean
true: activate when market price >= activation price, false: <= activation price
$.data.order.activation_pricestring
Activation price, 0 means trigger immediately
$.data.order.price_typeinteger格式："int32"；枚举：0 / 1 / 2 / 3
Activation price type: 0-unknown, 1-latest price, 2-index price, 3-mark price
$.data.order.price_offsetstring
Callback ratio or price distance, e.g., `0.1` or `0.1%`
$.data.order.textstring
Custom field
$.data.order.reduce_onlyboolean
Reduce Position Only
$.data.order.position_relatedboolean
Whether bound to position
$.data.order.created_atinteger格式："int64"
Created time
$.data.order.activated_atinteger格式："int64"
Activation time
$.data.order.finished_atinteger格式："int64"
End time
$.data.order.create_timeinteger格式："int64"
Created time
$.data.order.active_timeinteger格式："int64"
Activation time
$.data.order.finish_timeinteger格式："int64"
End time
$.data.order.reasonstring
End reason
$.data.order.suborder_textstring
Sub-order text field
$.data.order.is_dual_modeboolean
Whether dual position mode when creating order
$.data.order.trigger_pricestring
Trigger price
$.data.order.suborder_idinteger格式："int64"
Sub-order ID
$.data.order.side_labelstring
Order direction label: long/short/open long/open short/close long/close short
$.data.order.original_statusinteger格式："int32"
Order status
$.data.order.statusstring枚举：open / finished
Simplified order status: open/finished
$.data.order.position_side_outputstring
Same as side_label, client requires consistency with other order types
$.data.order.updated_atinteger格式："int64"
Update time
$.data.order.extremum_pricestring
Extremum price
$.data.order.status_codestring
Status code value
$.data.order.created_at_precisestring
Creation time (high precision, seconds.microseconds format)
$.data.order.finished_at_precisestring
End time (high precision, seconds.microseconds format)
$.data.order.activated_at_precisestring
Activation time (high precision, seconds.microseconds format)
$.data.order.status_labelstring
Status internationalization label (translated status text)
$.data.order.pos_margin_modestring
Position margin mode: isolated/cross
$.data.order.position_modestring
Position mode: single, dual, and dual_plus
$.data.order.error_labelstring
Error label
$.data.order.leveragestring
Leverage
$.timestampinteger格式："int64"
Response timestamp (milliseconds)

来源、版本与使用说明

本站独立整理 Gate 技术资料，不代表 Gate，不提供账户、交易、充值或软件下载服务。

参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格，固定版本为 v4.106.132。核对时官网文档已为 v4.106.136，后续变更须以官网为准；本页并未声称对该接口做过在线实测。

中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维；页面没有第三方统计脚本，表单参数仅在当前页面内存中处理。