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

官方网址

验证通道

交易机器人

客户端下载

客服邮箱 [email protected]