API REFERENCE / 现货
Gate 现货POV订单列表与任务状态：参数、响应与查询工具
按交易对、状态和方向查询现货 POV 订单，记录参与率、有效时长及开始结束时间。
需要官方 API 鉴权固定规格 v4.106.132资料核对：2026-09-10
GET /spot/pov_orders
这条查询解决什么问题
这是 POV 任务层的列表，participation_rate 是任务配置，不能解释为该账户已达到的市场成交占比。
这是账户数据查询文档。真实调用需要在你自己的可信环境完成官方鉴权；此页没有登录、密钥输入或账户连接功能。
查看官方英文说明
List Spot POV orders
此操作没有额外说明。
请求参数逐项核对
字段名和数据类型保留官方拼写。必填标记来自规格；描述中的条件约束还需要一起检查。
| 参数与位置 | 类型与范围 | 官方字段说明 |
|---|---|---|
currency_pairquery · 可选 | string | Currency pair |
statusquery · 必填 | string默认："open" | Order status. Defaults to open
- open: Active orders
- finished: Finished orders |
sidequery · 可选 | string | Specify all bids or all asks, both included if not specified |
pagequery · 可选 | integer格式："int32"；默认：1；最小：1；最大：100 | Page number, up to 100 |
limitquery · 可选 | integer默认：100；最小：1；最大：1000 | Maximum number of records returned in a single list |
在本页组装查询 URL
填写参数后生成一个 GET 地址，只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。
尚未生成 URL。
不会向 Gate 或本站发送表单内容。
工具检查必填、枚举与简单数值范围，不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。
响应字段怎样阅读
以下展示的是规格中的类型定义，不是现场 API 响应，也不是行情样本。嵌套结构展开至三层；数组的 [] 表示其中一个元素。
HTTP 200 · Query successful
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | array<object> | 未提供字段注释 |
$[] | object | Spot POV order details |
$[].id | string | Order ID |
$[].currency_pair | string | Currency pair |
$[].side | string | Buy or sell order |
$[].amount | string | Trade amount |
$[].participation_rate | integer | Target participation rate as a percentage. Allowed values: 5, 10, 20, and 40 |
$[].ttl | string | Time to live. Valid values: 1h, 6h, 12h, 1d, 2d, 3d, 4d, 5d, 6d, and 7d |
$[].limit_price | string | Limit price. If omitted, the market price is used |
$[].trigger_price | string | Trigger price. If omitted, the order is triggered immediately |
$[].status | string | Order status
- CREATED: Created
- CANCELING: Canceling
- RUNNING: Running
- COMPLETED: Completed
- EXPIRED: Expired
- TERMINATED: Terminated |
$[].terminated_as | string | Order termination reason code |
$[].start_time_ms | integer格式："int64" | Order execution start time in milliseconds |
$[].end_time_ms | integer格式："int64" | Order execution end time in milliseconds |
$[].expire_time_ms | integer格式："int64" | Order expiration time in milliseconds |
$[].create_time_ms | integer格式："int64" | Creation time of order (in milliseconds) |
$[].update_time_ms | integer格式："int64" | Last modification time of order (in milliseconds) |
$[].text | string | Order custom information. Users can set custom ID with this field. Custom fields must meet the following conditions:
1. Must start with `t-`
2. Excluding `t-`, length cannot exceed 28 bytes
3. Can only contain numbers, letters, underscore(_), hyphen(-) or dot(.)
|
来源、版本与使用说明
本站独立整理 Gate 技术资料，不代表 Gate，不提供账户、交易、充值或软件下载服务。
参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格，固定版本为 v4.106.132。核对时官网文档已为 v4.106.136，后续变更须以官网为准；本页并未声称对该接口做过在线实测。
中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维；页面没有第三方统计脚本，表单参数仅在当前页面内存中处理。