关于现有API行情接口将支持Trade ID的公告

尊敬的用户:

自本通知生效之日起,火币Global将在以下REST API节点中新增Trade ID返回字段 –
1)GET /market/trade 查询最近市场成交;
2)GET /market/history/trade 查询近期市场成交。

同时,以下Websocket API订阅主题/请求中将新增Trade ID返回字段 –
1)market.$symbol.trade.detail 订阅最近市场成交;
2)market.$symbol.trade.detail 请求最近市场成交。

Trade ID对于每笔市场成交唯一。如果一张taker订单与多张maker订单同时成交,每笔成交的Trade ID将会不同。

本次升级(新增Trade ID返回字段)仅限以上公共行情数据接口,私有数据接口(如成交明细GET /v1/order/matchresults)将暂时不增加此字段。

生效日期:2019年10月9日(GMT+8)
具体变更细节及参数要求,请参考【API文档】

火币全球站
2019年10月9日

以下为变更细节:
1、REST API – 最近市场成交查询节点
GET /market/trade (公共数据)
GET /market/history/trade (公共数据)
Request parameter(s)
与现有相同
Response:

Parameter

参数

Data Type

数据类型

Description

描述

Value Range

取值范围

idintUnique trade ID唯一交易id 
trade-idintUnique trade ID (NEW)唯一成交编号 
pricefloatTrade price成交价 
amountfloatTrade volume成交量 
tsintTrade time (unix time in millisecond)成交时间(unix time in millisecond) 
directionstringAggressive order side (buy or sell)成交主动方(buy or sell) 

2、Websocket API – 最近市场成交订阅/请求
market.$symbol.trade.detail (公共数据)
Request parameter(s)
与现有相同
Response:

Parameter

参数

Data Type

数据类型

Description

描述

Value Range

取值范围

idintUnique trade ID唯一交易id 
trade-idintUnique trade ID (NEW)唯一成交编号 
pricefloatTrade price成交价 
amountfloatTrade volume成交量 
tsintTrade time (unix time in millisecond)成交时间(unix time in millisecond) 
directionstringAggressive order side (buy or sell)成交主动方(buy or sell)