API REFERENCE / 现货
Gate 单个现货订单的成交与结束原因:参数、响应与查询工具
使用订单编号、交易对和账户条件查询一张现货订单,对照原始数量、已成交数量与结束原因。
需要官方 API 鉴权固定规格 v4.106.132资料核对:2026-09-10
GET /spot/orders/{order_id}这条查询解决什么问题
订单 status 与 finish_as 应联合解释,已结束订单仍可能有未成交部分,不能据结束时间认定全额成交。
这是账户数据查询文档。真实调用需要在你自己的可信环境完成官方鉴权;此页没有登录、密钥输入或账户连接功能。
查看官方英文说明
Query single order details
By default, queries orders for spot, unified account, and isolated margin accounts.
请求参数逐项核对
字段名和数据类型保留官方拼写。必填标记来自规格;描述中的条件约束还需要一起检查。
| 参数与位置 | 类型与范围 | 官方字段说明 |
|---|---|---|
order_idpath · 必填 | string | The order ID returned when the order was successfully created or the custom ID specified by the user's creation (i.e. the `text` field).
Operations based on custom IDs can only be checked in pending orders. Only order ID can be used after the order is finished (transaction/cancel) |
currency_pairquery · 必填 | string | Specify the trading pair to query. This field is required when querying pending order records. This field can be omitted when querying filled order records. |
accountquery · 可选 | string | Specify query account |
在本页组装查询 URL
填写参数后生成一个 GET 地址,只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。
尚未生成 URL。
不会向 Gate 或本站发送表单内容。
工具检查必填、枚举与简单数值范围,不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。
响应字段怎样阅读
以下展示的是规格中的类型定义,不是现场 API 响应,也不是行情样本。嵌套结构展开至三层;数组的 [] 表示其中一个元素。
HTTP 200 · Detail retrieved
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | object | Spot order details |
$.id | string | Order ID |
$.text | string | User defined information. If not empty, must follow the rules below:
1. prefixed with `t-`
2. no longer than 28 bytes without `t-` prefix
3. can only include 0-9, A-Z, a-z, underscore(_), hyphen(-) or dot(.)
Besides user defined information, reserved contents are listed below, denoting how the order is created:
- 101: from android
- 102: from IOS
- 103: from IPAD
- 104: from webapp
- 3: from web
- 2: from apiv2
- apiv4: from apiv4
pm_liquidate, comb_margin_liquidate, and scm_liquidate represent cross-margin liquidation orders
liquidate represents isolated-margin liquidation orders |
$.amend_text | string | The custom data that the user remarked when amending the order |
$.create_time | string | Creation time of order |
$.update_time | string | Last modification time of order |
$.create_time_ms | integer格式:"int64" | Creation time of order (in milliseconds) |
$.update_time_ms | integer格式:"int64" | Last modification time of order (in milliseconds) |
$.status | string枚举:open / closed / cancelled | Order status
- `open`: to be filled
- `closed`: closed order
- `cancelled`: cancelled |
$.currency_pair | string | Currency pair |
$.trade_quote | string | Actual quote currency used for the trade; can be specified only in a unified market |
$.type | string默认:"limit";枚举:limit / market | Order Type
- limit : Limit Order
- market : Market Order |
$.account | string默认:"spot" | Account type, spot - spot account, margin - leveraged account, unified - unified account |
$.side | string枚举:buy / sell | Buy or sell order |
$.amount | string | Trade amount
When `type` is `limit`, this is the base currency to trade (the currency being bought or sold), e.g. `BTC` in `BTC_USDT`.
When `type` is `market`, the meaning depends on the side:
- `side`: `buy` refers to the quote currency, e.g. `USDT` in `BTC_USDT`
- `side`: `sell` refers to the base currency, e.g. `BTC` in `BTC_USDT` |
$.price | string | Trading price, required when `type`=`limit` |
$.time_in_force | string默认:"gtc";枚举:gtc / ioc / poc / fok | Time in force
- gtc: GoodTillCancelled
- ioc: ImmediateOrCancelled, taker only
- poc: PendingOrCancelled, makes a post-only order that always enjoys a maker fee
- fok: FillOrKill, fill either completely or none
Only `ioc` and `fok` are supported when `type`=`market` |
$.iceberg | string | Amount to display for the iceberg order. Null or 0 for normal orders. Hiding all amount is not supported |
$.auto_borrow | boolean | Used in margin or cross margin trading to allow automatic loan of insufficient amount if balance is not enough |
$.auto_repay | boolean | Enable or disable automatic repayment for automatic borrow loan generated by cross margin order. Default is disabled. Note that:
1. This field is only effective for cross margin orders. Margin account does not support setting auto repayment for orders.
2. `auto_borrow` and `auto_repay` can be both set to true in one order |
$.left | string | Amount left to fill |
$.filled_amount | string | Amount filled |
$.fill_price | string | Total filled in quote currency. Deprecated in favor of `filled_total` |
$.filled_total | string | Total filled in quote currency |
$.avg_deal_price | string | Average fill price |
$.fee | string | Fee deducted |
$.fee_currency | string | Fee currency unit |
$.point_fee | string | Points used to deduct fee |
$.gt_fee | string | GT used to deduct fee |
$.gt_maker_fee | string | GT amount used to deduct maker fee |
$.gt_taker_fee | string | GT amount used to deduct taker fee |
$.gt_discount | boolean | Whether GT fee deduction is enabled |
$.rebated_fee | string | Rebated fee |
$.rebated_fee_currency | string | Rebated fee currency unit |
$.stp_id | integer | Orders between users in the same `stp_id` group are not allowed to be self-traded
1. If the `stp_id` of two orders being matched is non-zero and equal, they will not be executed. Instead, the corresponding strategy will be executed based on the `stp_act` of the taker.
2. `stp_id` returns `0` by default for orders that have not been set for `STP group` |
$.stp_act | string枚举:cn / co / cb / - | Self-Trading Prevention Action. Users can use this field to set self-trade prevention strategies
1. After users join the `STP Group`, they can pass `stp_act` to limit the user's self-trade prevention strategy. If `stp_act` is not passed, the default is `cn` strategy.
2. When the user does not join the `STP group`, an error will be returned when passing the `stp_act` parameter.
3. If the user did not use `stp_act` when placing the order, `stp_act` will return '-'
- cn: Cancel newest, cancel new orders and keep old ones
- co: Cancel oldest, cancel old orders and keep new ones
- cb: Cancel both, both old and new orders will be cancelled |
$.finish_as | string枚举:open / filled / cancelled / liquidate_cancelled / depth_not_enough / trader_not_enough / small / ioc / poc / fok / stp / price_protect_cancelled / unknown | How the order finished:
- open: Pending processing
- filled: Fully filled
- cancelled: Cancelled by user
- liquidate_cancelled: Cancelled by liquidation
- small: Order size too small
- depth_not_enough: Cancelled due to insufficient order book depth
- trader_not_enough: Cancelled due to insufficient counterparty liquidity
- ioc: Not filled immediately because time-in-force is IOC
- poc: Post-only requirement not met because time-in-force is set to poc (maker-only); rejected after being detected as taker
- fok: Not fully filled immediately because time-in-force is FOK
- stp: Cancelled due to self-trade prevention
- price_protect_cancelled: Cancelled due to price protection
- unknown: Unknown |
$.action_mode | string | Processing Mode:
When placing an order, different fields are returned based on action_mode. This field is only valid during the request and is not included in the response result
ACK: Asynchronous mode, only returns key order fields
RESULT: No clearing information
FULL: Full mode (default) |
$.slippage | string | Maximum supported slippage ratio for Spot Market Order Placement, calculated based on the latest market price at the time of order placement as the benchmark (Example: 0.03 means 3%) |
$.stop_profit | object | Take profit for limit orders. Pass {} to cancel take profit; pass null to leave take profit unchanged. |
$.stop_profit.trigger_price | string | Take profit trigger price
When `side == "buy"`, `trigger_price` must be greater than `price`
When `side == "sell"`, `trigger_price` must be less than `price` |
$.stop_profit.order_price | string | Take profit order price |
$.stop_loss | object | Stop loss for limit orders. Pass {} to cancel stop loss; pass null to leave stop loss unchanged. |
$.stop_loss.trigger_price | string | Stop loss trigger price
When `side == "buy"`, `trigger_price` must be less than `price`
When `side == "sell"`, `trigger_price` must be greater than `price` |
$.stop_loss.order_price | string | Stop-loss order price |
来源、版本与使用说明
本站独立整理 Gate 技术资料,不代表 Gate,不提供账户、交易、充值或软件下载服务。
参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格,固定版本为 v4.106.132。核对时官网文档已为 v4.106.136,后续变更须以官网为准;本页并未声称对该接口做过在线实测。
中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维;页面没有第三方统计脚本,表单参数仅在当前页面内存中处理。