关于API将新增财务流水查询接口“GET /v2/account/ledger”的公告

尊敬的用户：

自本通知生效之日起，火币Global将新增财务流水查询接口“GET /v2/account/ledger”。

GET /v2/account/ledger
API Key 权限：读取
母、子用户均可调用此接口

一期上线后暂时仅支持划转流水的查询（“transactType” = “transfer”）

通过“startTime”/“endTime”框定的查询窗口最大为10天，意即，通过单次查询可检索的范围最大为10天。
该查询窗口可在最近180天范围内平移，意即，通过多次平移窗口查询，最多可检索到过往180天的记录。

生效日期：2020年3月31日（GMT+8）

具体变更细节及参数要求，请参考API文档：https://huobiapi.github.io/docs/spot/v1/cn/

火币全球站
2020年3月31日

以下为变更明细：

请求参数

参数名称	数据类型	是否必需	描述
accountId	string	TRUE	账户编号
currency	string	FALSE	币种（缺省值所有币种）
transactType	string	FALSE	变动类型，可多填（缺省值all）枚举值：transfer
startTime	long	FALSE	远点时间（取值范围及缺省值见注1）
endTime	long	FALSE	近点时间（取值范围及缺省值见注2）
sort	string	FALSE	检索方向（asc由远及近,desc由近及远，缺省值desc）
limit	int	FALSE	单页最大返回条目数量[1,500]（缺省值100）
fromId	long	FALSE	起始编号（仅在下页查询时有效，见注3）

注1：

startTime取值范围：[(endTime - 10天), endTime]

startTime缺省值：(endTime - 10天)

注2：

endTime取值范围：[(当前时间 - 180天), 当前时间]

endTime缺省值：当前时间

返回数据

字段名称	字段名称	是否必需	描述
code	code	TRUE	状态码
message	message	FALSE	错误描述（如有）
data	data	TRUE	按用户请求参数sort中定义的顺序排列
{accountId	{accountId	TRUE	账户编号
currency	currency	TRUE	币种
transactAmt	transactAmt	TRUE	变动金额（入账为正or出账为负）
transactType	transactType	TRUE	变动类型
transactId	transactId	TRUE	交易流水号
transactTime	transactTime	TRUE	交易时间
transferer	transferer	FALSE	付款方账户ID（仅对转账之入账类型有效）
transferee}	transferee}	FALSE	收款方账户ID（仅对转账之出账类型有效）
nextId	nextId	FALSE	下页起始编号（仅在查询结果需要分页返回时，包含此字段

注3：

仅当用户请求查询的时间范围内的数据条目超出单页限制（由“limit“字段设定）时，服务器才返回”nextId“字段。用户收到服务器返回的”nextId“后 –

1）须知晓后续仍有数据未能在本页返回；

2）如需继续查询下页数据，应再次请求查询并将服务器返回的“nextId”作为“fromId“，其它请求参数不变。

3）“nextId”和”fromId“作为数据库记录ID，除了用来翻页查询外，无其它业务含义。

对用户的影响：

API用户需自行评估此新接口上线对用户自身业务的适配，并更新相关应用。

所有变更将自本通知生效之日起更新至 Huobi API Docs。