API REFERENCE / 永续合约
Gate 永续跟踪订单的修改记录：参数、响应与查询工具
查询指定永续跟踪任务的用户修改日志，按 updated_at 查看数量、激活价和偏移参数的变化。
需要官方 API 鉴权固定规格 v4.106.132资料核对：2026-09-10
GET /futures/{settle}/autoorder/v1/trail/change_log这条查询解决什么问题
修改日志记录的是配置变更，不能替代触发事件或成交记录，is_create 还应与后续修改条目区分。
这是账户数据查询文档。真实调用需要在你自己的可信环境完成官方鉴权；此页没有登录、密钥输入或账户连接功能。
查看官方英文说明
Get trail order user modification records
此操作没有额外说明。
请求参数逐项核对
字段名和数据类型保留官方拼写。必填标记来自规格；描述中的条件约束还需要一起检查。
| 参数与位置 | 类型与范围 | 官方字段说明 |
|---|---|---|
settlepath · 必填 | string枚举：btc / usdt / usd1 | Perpetual futures settlement currency |
idquery · 必填 | integer格式："int64" | Order ID |
page_numquery · 可选 | integer格式："int32"；默认：1 | Page number, starting from 1 |
page_sizequery · 可选 | integer格式："int32"；默认：20 | Number of items per page |
在本页组装查询 URL
填写参数后生成一个 GET 地址，只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。
尚未生成 URL。
不会向 Gate 或本站发送表单内容。
工具检查必填、枚举与简单数值范围，不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。
响应字段怎样阅读
以下展示的是规格中的类型定义，不是现场 API 响应，也不是行情样本。嵌套结构展开至三层；数组的 [] 表示其中一个元素。
HTTP 200 · Query successful
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | object | 未提供字段注释 |
$.change_log | array<object> | 未提供字段注释 |
$.change_log[] | object | Trail order modification records |
$.change_log[].updated_at | integer格式："int64" | Update time |
$.change_log[].amount | string | Trading quantity in contracts, positive for buy, negative for sell |
$.change_log[].is_gte | boolean | true: activate when market price >= activation price, false: <= activation price |
$.change_log[].activation_price | string | Activation price, 0 means trigger immediately |
$.change_log[].price_type | integer格式："int32"；枚举：0 / 1 / 2 / 3 | Activation price type: 0-unknown, 1-latest price, 2-index price, 3-mark price |
$.change_log[].price_offset | string | Callback ratio or price distance, e.g., `0.1` or `0.1%` |
$.change_log[].is_create | boolean | true - order creation, false - order modification |
来源、版本与使用说明
本站独立整理 Gate 技术资料，不代表 Gate，不提供账户、交易、充值或软件下载服务。
参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格，固定版本为 v4.106.132。核对时官网文档已为 v4.106.136，后续变更须以官网为准；本页并未声称对该接口做过在线实测。
中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维；页面没有第三方统计脚本，表单参数仅在当前页面内存中处理。