关于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日

 

以下为变更明细:

请求参数

参数名称数据类型是否必需描述
accountIdstringTRUE账户编号
currencystringFALSE币种(缺省值所有币种)
transactTypestringFALSE变动类型,可多填(缺省值all)枚举值:transfer
startTimelongFALSE远点时间(取值范围及缺省值见注1)
endTimelongFALSE近点时间(取值范围及缺省值见注2)
sortstringFALSE检索方向(asc由远及近,desc由近及远,缺省值desc)
limitintFALSE单页最大返回条目数量[1,500](缺省值100)
fromIdlongFALSE起始编号(仅在下页查询时有效,见注3)

注1:

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

startTime缺省值:(endTime - 10天)

 

注2:

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

endTime缺省值:当前时间

 

返回数据

字段名称字段名称是否必需描述
codecodeTRUE状态码
messagemessageFALSE错误描述(如有)
datadataTRUE按用户请求参数sort中定义的顺序排列
{accountId{accountIdTRUE账户编号
currencycurrencyTRUE币种
transactAmttransactAmtTRUE变动金额(入账为正or出账为负)
transactTypetransactTypeTRUE变动类型
transactIdtransactIdTRUE交易流水号
transactTimetransactTimeTRUE交易时间
transferertransfererFALSE付款方账户ID(仅对转账之入账类型有效)
transferee}transferee}FALSE收款方账户ID(仅对转账之出账类型有效)
nextIdnextIdFALSE下页起始编号(仅在查询结果需要分页返回时,包含此字段

注3:

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

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

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

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

对用户的影响:

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

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