Gate 个人现货成交与账户类型：参数、响应与查询工具
按交易对、账户类型和时间条件读取个人现货成交，关联成交角色、订单编号及实际手续费字段。
GET /spot/my_trades
这条查询解决什么问题
时间条件按订单结束时间处理且跨度不超过三十天，不能直接按成交时间自行假设筛选边界。
这是账户数据查询文档。真实调用需要在你自己的可信环境完成官方鉴权；此页没有登录、密钥输入或账户连接功能。
查看官方英文说明
Query personal trading records
By default query of transaction records for spot, unified account and warehouse-by-site leverage accounts. The history within a specified time range can be queried by specifying `from` or (and) `to`. - If no time parameters are specified, only data for the last 7 days can be obtained. - If only any parameter of `from` or `to` is specified, only 7-day data from the start (or end) of the specified time is returned. - The range not allowed to exceed 30 days. The parameters of the time range filter are processed according to the order end time. The maximum number of pages when searching data using limit&page paging function is 100,000, that is, limit * (page - 1) <= 100,000.
请求参数逐项核对
字段名和数据类型保留官方拼写。必填标记来自规格；描述中的条件约束还需要一起检查。
| 参数与位置 | 类型与范围 | 官方字段说明 |
|---|---|---|
currency_pairquery · 可选 | string | Retrieve results with specified currency pair |
limitquery · 可选 | integer默认：100；最小：1；最大：1000 | Maximum number of items returned in list. Default: 100, minimum: 1, maximum: 1000 |
pagequery · 可选 | integer格式："int32"；默认：1；最小：1 | Page number |
order_idquery · 可选 | string | Filter trades with specified order ID. `currency_pair` is also required if this field is present |
accountquery · 可选 | string | The accountparameter has been deprecated. The interface supports querying all transaction records of the account. |
fromquery · 可选 | integer格式："int64" | Start timestamp for the query |
toquery · 可选 | integer格式："int64" | End timestamp for the query, defaults to current time if not specified |
在本页组装查询 URL
填写参数后生成一个 GET 地址，只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。
尚未生成 URL。
不会向 Gate 或本站发送表单内容。
工具检查必填、枚举与简单数值范围，不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。
响应字段怎样阅读
以下展示的是规格中的类型定义，不是现场 API 响应，也不是行情样本。嵌套结构展开至三层；数组的 [] 表示其中一个元素。
HTTP 200 · List retrieved successfully
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | array<object> | 未提供字段注释 |
$[] | object | 未提供字段注释 |
$[].id | string | Fill ID |
$[].create_time | string | Fill Time |
$[].create_time_ms | string | Trading time, with millisecond precision |
$[].currency_pair | string | Currency pair |
$[].side | string枚举：buy / sell | Buy or sell order |
$[].role | string枚举：taker / maker | Trade role, not returned in public endpoints |
$[].amount | string | Trade amount |
$[].price | string | Order price |
$[].order_id | string | Related order ID, not returned in public endpoints |
$[].fee | string | Fee deducted, not returned in public endpoints |
$[].fee_currency | string | Fee currency unit, not returned in public endpoints |
$[].point_fee | string | Points used to deduct fee, not returned in public endpoints |
$[].gt_fee | string | GT used to deduct fee, not returned in public endpoints |
$[].amend_text | string | The custom data that the user remarked when amending the order |
$[].sequence_id | string | Consecutive trade ID within a single market.
Used to track and identify trades in the specific market |
$[].text | string | Order's Custom Information. This field is not returned by public interfaces.
The scenarios pm_liquidate, comb_margin_liquidate, and scm_liquidate represent full-account forced liquidation orders.
liquidate represents isolated-account forced liquidation orders. |
$[].deal | string | Total Executed Value |
$[].trade_quote | string | Actual quote currency used for the trade |
来源、版本与使用说明
本站独立整理 Gate 技术资料，不代表 Gate，不提供账户、交易、充值或软件下载服务。
参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格，固定版本为 v4.106.132。核对时官网文档已为 v4.106.136，后续变更须以官网为准；本页并未声称对该接口做过在线实测。
中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维；页面没有第三方统计脚本，表单参数仅在当前页面内存中处理。