关于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权限：读取）

请求参数

参数名称	是否必须	类型	描述	默认值	取值范围
symbol	true	string	交易对		btcusdt, ethbtc...（取值参考GET /v1/common/symbols）
types	false	string	查询的订单类型组合，使用逗号分割		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-time	false	string	查询开始时间, 时间格式UTC time in millisecond。 以订单生成时间进行查询	-48h 查询结束时间的前48小时	取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近180天，已完全撤销的历史订单的查询窗口平移范围只有最近24小时(state="canceled")
end-time	false	string	查询结束时间, 时间格式UTC time in millisecond。 以订单生成时间进行查询	present	取值范围 [(present-179d), present] ，查询窗口最大为48小时，窗口平移范围为最近180天，已完全撤销的历史订单的查询窗口平移范围只有最近24小时(state="canceled")
start-date	false	string	查询开始日期, 日期格式yyyy-mm-dd。 以订单生成时间进行查询	-1d 查询结束日期的前1天	取值范围 [((end-date) – 1), (end-date)] ，查询窗口最大为2天，窗口平移范围为最近180天，已完全撤销的历史订单的查询窗口平移范围只有最近1天(state="canceled")
end-date	false	string	查询结束日期, 日期格式yyyy-mm-dd。 以订单生成时间进行查询	today	取值范围 [(today-179), today] ，查询窗口最大为2天，窗口平移范围为最近180天，已完全撤销的历史订单的查询窗口平移范围只有最近1天(state="canceled")
states	true	string	查询的订单状态组合，使用','分割		submitted 已提交, partial-filled 部分成交, partial-canceled 部分成交撤销, filled 完全成交, canceled 已撤销，created
from	false	string	查询起始 ID
direct	false	string	查询方向		prev 向前，时间（或 ID）正序；next 向后，时间（或 ID）倒序）
size	false	string	查询记录大小	100	[1, 100]

响应数据

参数名称	是否必须	数据类型	描述	取值范围
account-id	true	long	账户 ID
amount	true	string	订单数量
canceled-at	false	long	接到撤单申请的时间
created-at	true	long	订单创建时间
field-amount	true	string	已成交数量
field-cash-amount	true	string	已成交总金额
field-fees	true	string	已成交手续费（买入为基础币，卖出为计价币）
finished-at	false	long	最后成交时间
id	true	long	订单ID
price	true	string	订单价格
source	true	string	订单来源	api
state	true	string	订单状态	submitted 已提交, partial-filled 部分成交, partial-canceled 部分成交撤销, filled 完全成交, canceled 已撤销，created
symbol	true	string	交易对	btcusdt, ethbtc, rcneth ...
type	true	string	订单类型	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-price	false	string	止盈止损订单触发价格
operator	false	string	止盈止损订单触发价运算符	gte,lte