eth2345

DragonEx的Logo

火币全球站

火币全球专业站,是火币集团旗下服务于全球专业交易用户的创新数字资产交易平台,致力于发现优质的创新数字资产投资机会,目前提供四十多种数字资产品类的交易及投资服务,总部位于新加坡,由火币全球专业站团队负责运营。

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

发布于 2020-02-07 19:22:18 内容以 原文链接为准

尊敬的用户:

当前,火币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
ETH2345, 专业区块链导航网站