API REFERENCE / 永续合约

Gate 永续追价任务列表与分页：参数、响应与查询工具

按合约、时间、结束状态和方向筛选永续追价任务，并使用 page_num、page_size 分页。

需要官方 API 鉴权固定规格 v4.106.132资料核对：2026-09-10

GET /futures/{settle}/autoorder/v1/chase/list

这条查询解决什么问题

hide_cancel 会改变返回任务范围，比较两次列表时应保留该筛选条件，避免把被过滤任务当作记录消失。

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

查看官方英文说明

List chase orders

此操作没有额外说明。

请求参数逐项核对

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

参数与位置	类型与范围	官方字段说明
`settle`path · 必填	`string`枚举：btc / usdt / usd1	Perpetual futures settlement currency
`contract`query · 可选	`string`	Optional. When non-empty, must be a valid contract (validated against the market cache for the path settle); server-side converted to uppercase
`is_finished`query · 可选	`boolean`	true to query finished orders, false to query in-progress orders
`start_at`query · 可选	`integer`格式："int64"	Lower time bound for the history list, paired with end_at. Required when is_finished is true
`end_at`query · 可选	`integer`格式："int64"	Upper time bound for the history list, paired with start_at. Required when is_finished is true
`page_num`query · 可选	`integer`格式："uint32"；最小：1	Page number, starting from 1
`page_size`query · 可选	`integer`格式："uint32"；最小：1；最大：100	Page size; must be between 1 and 100
`sort_by`query · 必填	`integer`枚举：1 / 2	Sort field: 1 ORDER_SORT_CREATED_AT, 2 ORDER_SORT_FINISHED_AT; cannot be 0
`hide_cancel`query · 可选	`boolean`	When true, cancelled orders are hidden in the list
`reduce_only`query · 可选	`integer`枚举：0 / 1 / 2	OptionalBool: 0 unknown, 1 true, 2 false; used to filter by reduce-only flag
`side`query · 可选	`integer`枚举：0 / 1 / 2	Filter by long/short side: 1 long, 2 short

在本页组装查询 URL

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

尚未生成 URL。

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

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

响应字段怎样阅读

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

HTTP 200 · Success

字段路径	数据类型	字段说明
`$`	`object`	未提供字段注释
`$.orders`	`array<object>`	未提供字段注释
`$.orders[]`	`object`	Chase order detail or list item
`$.orders[].id`	`string`	未提供字段注释
`$.orders[].user`	`string`	未提供字段注释
`$.orders[].contract`	`string`	未提供字段注释
`$.orders[].settle`	`string`	未提供字段注释
`$.orders[].amount`	`string`	Total size in contracts; positive for buy, negative for sell
`$.orders[].price_limit`	`string`	未提供字段注释
`$.orders[].reduce_only`	`boolean`	未提供字段注释
`$.orders[].text`	`string`	未提供字段注释
`$.orders[].create_time`	`integer`格式："int64"	未提供字段注释
`$.orders[].finish_time`	`integer`格式："int64"	未提供字段注释
`$.orders[].original_status`	`integer`	Raw status enum
`$.orders[].status`	`string`	Simplified status, e.g. open / finished
`$.orders[].reason`	`string`	未提供字段注释
`$.orders[].fill_amount`	`string`	未提供字段注释
`$.orders[].average_fill_price`	`string`	未提供字段注释
`$.orders[].suborder_id`	`string`	未提供字段注释
`$.orders[].is_dual_mode`	`boolean`	未提供字段注释
`$.orders[].side_label`	`string`	未提供字段注释
`$.orders[].position_side_output`	`string`	未提供字段注释
`$.orders[].chase_price`	`string`	未提供字段注释
`$.orders[].interval_sec`	`integer`格式："uint32"	未提供字段注释
`$.orders[].updated_at`	`integer`格式："int64"	未提供字段注释
`$.orders[].suborder_price`	`string`	未提供字段注释
`$.orders[].suborder_ongoing`	`boolean`	未提供字段注释
`$.orders[].suborder_finish_as`	`string`	未提供字段注释
`$.orders[].price_type`	`integer`	PriceType enum: 1 latest, 2 index, 3 mark
`$.orders[].price_gap_type`	`string`	未提供字段注释
`$.orders[].price_gap_value`	`string`	未提供字段注释
`$.orders[].status_code`	`string`	未提供字段注释
`$.orders[].create_time_precise`	`string`	Creation time (seconds.microseconds)
`$.orders[].finish_time_precise`	`string`	未提供字段注释
`$.orders[].pos_margin_mode`	`string`	未提供字段注释
`$.orders[].position_mode`	`string`	未提供字段注释
`$.orders[].leverage`	`string`	未提供字段注释
`$.orders[].error_label`	`string`	未提供字段注释

来源、版本与使用说明

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

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

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