API REFERENCE / 永续合约

Gate 永续账户账务类型与合约筛选：参数、响应与查询工具

按结算币、资金变动类型和时间窗口读取永续账本，区分手续费、资金费用和持仓损益等项目。

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

GET /futures/{settle}/account_book

这条查询解决什么问题

使用 contract 过滤只覆盖文档说明中二〇二三年十月三十日后带该字段的记录，不能视为完整历史合约账单。

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

查看官方英文说明

Query futures account change history

If the contract field is passed, only records containing this field after 2023-10-30 can be filtered。

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

参数与位置	类型与范围	官方字段说明
`settle`path · 必填	`string`枚举：btc / usdt / usd1	Perpetual futures settlement currency
`contract`query · 可选	`string`	Futures contract, return related data only if specified
`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
`from`query · 可选	`integer`格式："int64"	Start timestamp Specify start time, time format is Unix timestamp. If not specified, it defaults to (the data start time of the time range actually returned by to and limit)
`to`query · 可选	`integer`格式："int64"	Termination Timestamp Specify the end time. If not specified, it defaults to the current time, and the time format is a Unix timestamp
`type`query · 可选	`string`	Change types: - dnw: Deposit and withdrawal - pnl: Profit and loss from position reduction - fee: Trading fees - refr: Referrer rebates - fund: Funding fees - point_dnw: Point card deposit and withdrawal - point_fee: Point card trading fees - point_refr: Point card referrer rebates - bonus_offset: Trial fund deduction

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

尚未生成 URL。

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

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

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

字段路径	数据类型	字段说明
`$`	`array<object>`	未提供字段注释
`$[]`	`object`	未提供字段注释
`$[].time`	`number`格式："double"	Change time
`$[].change`	`string`	Change amount
`$[].balance`	`string`	Balance after change
`$[].type`	`string`枚举：dnw / pnl / fee / refr / fund / point_dnw / point_fee / point_refr / bonus_offset	Change types: - dnw: Deposit and withdrawal - pnl: Profit and loss from position reduction - fee: Trading fees - refr: Referrer rebates - fund: Funding fees - point_dnw: Point card deposit and withdrawal - point_fee: Point card trading fees - point_refr: Point card referrer rebates - bonus_offset: Trial fund deduction
`$[].text`	`string`	Comment
`$[].contract`	`string`	Futures contract, the field is only available for data after 2023-10-30
`$[].trade_id`	`string`	trade id
`$[].id`	`string`	Account change record ID

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

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

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