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

取值范围

id int Unique trade ID唯一交易id  
trade-id int Unique trade ID (NEW)唯一成交编号  
price float Trade price成交价  
amount float Trade volume成交量  
ts int Trade time (unix time in millisecond)成交时间(unix time in millisecond)  
direction string Aggressive 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

取值范围

id int Unique trade ID唯一交易id  
trade-id int Unique trade ID (NEW)唯一成交编号  
price float Trade price成交价  
amount float Trade volume成交量  
ts int Trade time (unix time in millisecond)成交时间(unix time in millisecond)  
direction string Aggressive order side (buy or sell)成交主动方(buy or sell)