API REFERENCE / 现货

Gate 现货条件单列表与触发状态：参数、响应与查询工具

按状态、市场和账户查询现货条件单，分别读取触发条件与触发后提交订单的配置。

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

GET /spot/price_orders

这条查询解决什么问题

条件单记录属于触发流程，fired_order_id 关联后续订单，不能把条件满足直接等同于现货成交。

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

查看官方英文说明

Query running auto order list

此操作没有额外说明。

请求参数逐项核对

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

参数与位置	类型与范围	官方字段说明
`status`query · 必填	`string`枚举：open / finished	Query order list based on status
`market`query · 可选	`string`	Trading market
`account`query · 可选	`string`枚举：normal / margin / unified	Trading account type. Unified account must be set to `unified`
`limit`query · 可选	`integer`默认：100；最小：1；最大：1000	Maximum number of records returned in a single list
`offset`query · 可选	`integer`默认：0；最小：0	List offset, starting from 0

在本页组装查询 URL

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

尚未生成 URL。

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

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

响应字段怎样阅读

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

HTTP 200 · List retrieved successfully

字段路径	数据类型	字段说明
`$`	`array<object>`	未提供字段注释
`$[]`	`object`	Spot price order details
`$[].trigger`	`object`	未提供字段注释
`$[].trigger.price`	`string`	Trigger price
`$[].trigger.rule`	`string`枚举：>= / <=	Price trigger condition - `>=`: triggered when market price is greater than or equal to `price` - `<=`: triggered when market price is less than or equal to `price`
`$[].trigger.expiration`	`integer`	Maximum wait time for trigger condition (in seconds). Order will be cancelled if timeout
`$[].put`	`object`	未提供字段注释
`$[].put.type`	`string`默认："limit"；枚举：limit / market	Order type，default to `limit` - limit : Limit Order - market : Market Order
`$[].put.side`	`string`枚举：buy / sell	Order side - buy: buy side - sell: sell side
`$[].put.price`	`string`	Order price
`$[].put.amount`	`string`	Trading quantity, refers to the trading quantity of the trading currency, i.e., the currency that needs to be traded, for example, the quantity of BTC in BTC_USDT.
`$[].put.account`	`string`默认："normal"；枚举：normal / margin / unified	Trading account type. Unified account must be set to `unified` - normal: spot trading - margin: margin trading - unified: unified account
`$[].put.time_in_force`	`string`默认："gtc"；枚举：gtc / ioc	time_in_force - gtc: GoodTillCancelled - ioc: ImmediateOrCancelled, taker only
`$[].put.auto_borrow`	`boolean`默认：false	Whether to borrow coins automatically
`$[].put.auto_repay`	`boolean`默认：false	Whether to repay the loan automatically
`$[].put.text`	`string`	The source of the order, including: - web: Web - api: API call - app: Mobile app
`$[].id`	`integer`格式："int64"	Auto order ID
`$[].user`	`integer`	User ID
`$[].market`	`string`	Market
`$[].ctime`	`integer`格式："int64"	Created time
`$[].ftime`	`integer`格式："int64"	End time
`$[].fired_order_id`	`integer`格式："int64"	ID of the order created after trigger
`$[].status`	`string`	Status - open: Running - cancelled: Manually cancelled - finish: Successfully completed - failed: Failed to execute - expired: Expired
`$[].reason`	`string`	Additional description of how the order was completed

来源、版本与使用说明

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

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

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