关于API将在现有历史订单查询节点GET /v1/order/orders中新增以“时间范围”查询的字段

尊敬的用户:

当前,火币Global现有节点GET /v1/order/orders支持用户以“日期范围“查询历史订单。用户通过设定start-date/end-date参数,可查询指定的两日内的历史订单。

自本通知生效之日起,火币Global将在以下现有历史订单查询节点GET /v1/order/orders中新增以“时间范围“查询的字段 –
start-time
end-time

届时,用户可选择以“时间范围”查询历史订单,以替代原先的以“日期范围“查询方式。

如用户填写start-time AND/OR end-time查询历史订单,服务器将按照用户指定的“时间范围“查询并返回,并忽略start-date/end-date参数。此方式的查询窗口大小限定为最大48小时,窗口平移范围为最近180天。

如用户不填写start-time/end-time参数,而填写start-date AND/OR end-date查询历史订单,服务器将按照用户指定的“日期范围“查询并返回。此方式的查询窗口大小限定为最大2天,窗口平移范围为最近180天。

如用户既不填写start-time/end-time参数,也不填写start-date/end-date参数,服务器将按以当前时间为end-time,返回最近48小时内的历史订单。

火币Global建议用户以“时间范围”查询历史订单。未来,火币Global将下线以”日期范围“查询历史订单的方式,并另行通知。

生效日期:2020年2月6日(GMT+8)
具体变更细节及参数要求,请参考API文档:https://huobiapi.github.io/docs/spot/v1/cn/

火币全球站
2020年2月7日

以下为变更明细:

REST API – - 历史订单查询节点

GET /v1/order/orders (API Key权限:读取)

请求参数

参数名称是否必须类型描述默认值取值范围
symboltruestring交易对 btcusdt, ethbtc...(取值参考GET /v1/common/symbols)
typesfalsestring查询的订单类型组合,使用逗号分割 buy-market:市价买, sell-market:市价卖, buy-limit:限价买, sell-limit:限价卖, buy-ioc:IOC买单, sell-ioc:IOC卖单, buy-limit-maker, sell-limit-maker, buy-stop-limit,sell-stop-limit
start-timefalsestring查询开始时间, 时间格式UTC time in millisecond。 以订单生成时间进行查询-48h 查询结束时间的前48小时取值范围 [((end-time) – 48h), (end-time)] ,查询窗口最大为48小时,窗口平移范围为最近180天,已完全撤销的历史订单的查询窗口平移范围只有最近24小时(state="canceled")
end-timefalsestring查询结束时间, 时间格式UTC time in millisecond。 以订单生成时间进行查询present取值范围 [(present-179d), present] ,查询窗口最大为48小时,窗口平移范围为最近180天,已完全撤销的历史订单的查询窗口平移范围只有最近24小时(state="canceled")
start-datefalsestring查询开始日期, 日期格式yyyy-mm-dd。 以订单生成时间进行查询-1d 查询结束日期的前1天取值范围 [((end-date) – 1), (end-date)] ,查询窗口最大为2天,窗口平移范围为最近180天,已完全撤销的历史订单的查询窗口平移范围只有最近1天(state="canceled")
end-datefalsestring查询结束日期, 日期格式yyyy-mm-dd。 以订单生成时间进行查询today取值范围 [(today-179), today] ,查询窗口最大为2天,窗口平移范围为最近180天,已完全撤销的历史订单的查询窗口平移范围只有最近1天(state="canceled")
statestruestring查询的订单状态组合,使用','分割 submitted 已提交, partial-filled 部分成交, partial-canceled 部分成交撤销, filled 完全成交, canceled 已撤销,created
fromfalsestring查询起始 ID  
directfalsestring查询方向 prev 向前,时间(或 ID)正序;next 向后,时间(或 ID)倒序)
sizefalsestring查询记录大小100[1, 100]

响应数据

参数名称是否必须数据类型描述取值范围
account-idtruelong账户 ID 
amounttruestring订单数量 
canceled-atfalselong接到撤单申请的时间 
created-attruelong订单创建时间 
field-amounttruestring已成交数量 
field-cash-amounttruestring已成交总金额 
field-feestruestring已成交手续费(买入为基础币,卖出为计价币) 
finished-atfalselong最后成交时间 
idtruelong订单ID 
pricetruestring订单价格 
sourcetruestring订单来源api
statetruestring订单状态submitted 已提交, partial-filled 部分成交, partial-canceled 部分成交撤销, filled 完全成交, canceled 已撤销,created
symboltruestring交易对btcusdt, ethbtc, rcneth ...
typetruestring订单类型submit-cancel:已提交撤单申请 ,buy-market:市价买, sell-market:市价卖, buy-limit:限价买, sell-limit:限价卖, buy-ioc:IOC买单, sell-ioc:IOC卖单, buy-limit-maker, sell-limit-maker, buy-stop-limit,sell-stop-limit
stop-pricefalsestring止盈止损订单触发价格 
operatorfalsestring止盈止损订单触发价运算符gte,lte