关于API将在现有接口中支持交易手续费返佣的公告

尊敬的用户:

火币Global 将在现有API接口中支持交易手续费返佣 –

1) 现有REST节点GET /v2/reference/transact-fee-rate中的makerFeeRate & actualMakerRate字段可返回实际返佣费率(如有);
2) 现有REST节点GET /v1/order/orders/{order-id}/matchresults中的filled-fees字段可返回交易手续费返佣(如有);
3) 现有REST节点GET /v1/order/matchresults中的filled-fees字段可返回交易手续费返佣(如有);
4) 现有v2版本清算后成交明细订阅主题trade.clearing#${symbol}中的transactFee字段可推送交易手续费返佣(如有);
5) 现有REST节点GET /v1/account/history中的transact-type字段可返回返佣类型(如有);
6) 现有v1版本账户更新订阅主题accounts可推送批量返佣金额(如有);
7) 现有v2版本账户更新订阅主题accounts.update#${mode}可推送批量返佣金额(如有)。

注:
- 现有v1版本订单更新订阅主题orders.$symbol中的filled-fees字段将不推送返佣金额。如以maker成交并适用返佣,filled-fees将更新为零值;
- 现有REST查询接口GET /v1/order/orders/{order-id}中的field-fees字段将不支持返佣金额;
- 现有REST查询接口GET /v1/order/orders/getClientOrder中的field-fees字段将不支持返佣金额;
- 现有REST查询接口GET /v1/order/orders中的field-fees字段将不支持返佣金额;
- 现有REST查询接口GET /v1/order/history中的field-fees字段将不支持返佣金额。

生效日期:2020年6月1日(GMT+8)

具体变更细节及参数要求,请参考API文档:https://huobiapi.github.io/docs/spot/v1/cn/

火币全球站
2020年5月27日

 

自本通知生效之日起,火币Global 将在现有API接口中支持交易手续费返佣 –

1) 现有REST节点GET /v2/reference/transact-fee-rate中的makerFeeRate & actualMakerRate字段可返回实际返佣费率(如有)-

响应数据

字段名称数据类型描述
codeinteger状态码
messagestring错误描述(如有)
dataobject 
{ symbolstring交易代码
makerFeeRatestring基础费率 - 被动方,如适用交易手续费返佣,返回返佣费率(负值)
takerFeeRatestring基础费率 - 主动方
actualMakerRatestring抵扣后费率 - 被动方,如不适用抵扣或未启用抵扣,返回基础费率;如适用交易手续费返佣,返回返佣费率(负值)
actualTakerRate }string抵扣后费率 – 主动方,如不适用抵扣或未启用抵扣,返回基础费率

 

注:
- 如makerFeeRate/actualMakerRate为正值,该字段意为交易手续费率;
- 如makerFeeRate/actualMakerRate为负值,该字段意为返佣费率。

2) 现有REST节点GET /v1/order/orders/{order-id}/matchresults中的filled-fees字段可返回交易手续费返佣(如有)-

响应数据

字段名称是否必须数据类型描述取值范围
created-attruelong成交时间戳timestamp 
filled-amounttruestring成交数量 
filled-feestruestring成交手续费,如果为空或为0,代表使用了其他币种进行了抵扣,可根据filled-points和fee-deduct-currency字段判断;如适用交易手续费返佣,返回为返佣金额(负值) 
idtruelong订单成交记录ID 
match-idtruelong撮合ID,订单在撮合中执行的顺序ID 
order-idtruelong订单ID,成交所属订单的ID 
trade-idfalseintegerUnique trade ID (NEW)唯一成交编号,成交时产生的唯一编号ID 
pricetruestring成交价格 
sourcetruestring订单来源api
symboltruestring交易对btcusdt, ethbtc, rcneth ...
typetruestring订单类型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, buy-limit-fok, sell-limit-fok, buy-stop-limit-fok, sell-stop-limit-fok
roletruestring成交角色maker,taker
filled-pointstruestring抵扣数量(可为ht或hbpoint) 
fee-deduct-currencytruestring抵扣类型如果为空,代表扣除的手续费是原币;如果为"ht",代表抵扣手续费的是HT;如果为"hbpoint",代表抵扣手续费的是点卡

 

注:
- filled-fees中的返佣金额可能不会实时到账;
- maker买单的返佣基于计价币种,maker卖单的返佣基于基础币种。

3) 现有REST节点GET /v1/order/matchresults中的filled-fees字段可返回交易手续费返佣(如有)-

响应数据

参数名称是否必须数据类型描述取值范围
created-attruelong成交时间戳timestamp 
filled-amounttruestring成交数量 
filled-feestruestring成交手续费;如适用交易手续费返佣,返回为返佣金额(负值) 
idtruelong订单成交记录 ID 
match-idtruelong撮合 ID 
order-idtruelong订单 ID 
trade-idfalseintegerUnique trade ID (NEW)唯一成交编号 
pricetruestring成交价格 
sourcetruestring订单来源api
symboltruestring交易对btcusdt, ethbtc, rcneth ...
typetruestring订单类型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, buy-limit-fok, sell-limit-fok, buy-stop-limit-fok, sell-stop-limit-fok
roletruestring成交角色maker,taker
filled-pointstruestring抵扣数量(可为ht或hbpoint) 
fee-deduct-currencytruestring抵扣类型ht,hbpoint

 

注:
- filled-fees中的返佣金额可能不会实时到账;
- maker买单的返佣基于计价币种,maker卖单的返佣基于基础币种。

4) 现有v2版本清算后成交明细订阅主题trade.clearing#${symbol}中的transactFee字段可返回交易手续费返佣(如有)-

数据更新字段列表

字段数据类型描述
symbolstring交易代码
orderIdlong订单ID
tradePricestring成交价
tradeVolumestring成交量
orderSidestring订单方向,有效值: buy, sell
orderTypestring订单类型,有效值: buy-market, sell-market,buy-limit,sell-limit,buy-ioc,sell-ioc,buy-limit-maker,sell-limit-maker,buy-stop-limit,sell-stop-limit,buy-limit-fok, sell-limit-fok, buy-stop-limit-fok, sell-stop-limit-fok
aggressorbool是否交易主动方,有效值: true, false
tradeIdlong交易ID
tradeTimelong成交时间,unix time in millisecond
transactFeestring交易手续费;如适用交易手续费返佣,返回为返佣金额(负值)
feeDeductstring交易手续费抵扣
feeDeductTypestring交易手续费抵扣类型,有效值: ht,point

 

注:
- transactFee中的返佣金额可能不会实时到账;
- maker买单的返佣基于计价币种,maker卖单的返佣基于基础币种。

5) 现有REST节点GET /v1/account/history中的transact-type字段可返回返佣类型(如有)-

响应数据

字段名称数据类型描述取值范围
statusstring状态码 
dataobject  
{ account-idlong账户编号 
currencystring币种 
transact-amtstring变动金额(入账为正 or 出账为负) 
transact-typestring变动类型,包括:trade (交易),etf(ETF申购), transact-fee(交易手续费), deduction(手续费抵扣), transfer(划转), credit(借币), liquidation(清仓), interest(币息), deposit(充币),withdraw(提币), withdraw-fee(提币手续费), exchange(兑换), other-types(其他), rebate(返佣) 
avail-balancestring可用余额 
acct-balancestring账户余额 
transact-timelong交易时间(数据库记录时间) 
record-id }string数据库记录编号(全局唯一) 

 

注:
账户流水中返回的返佣金额为到账金额,多笔成交产生的多笔返佣可能会合并到帐,成为一笔流水。

6) 现有v1版本账户更新订阅主题accounts可推送批量返佣金额(如有)-

数据更新字段列表

字段数据类型描述
eventstring资产变化通知相关事件说明,比如订单创建(order.place) 、订单成交(order.match)、订单成交退款(order.refund)、订单撤销(order.cancel) 、点卡抵扣交易手续费(order.fee-refund)、杠杆账户划转(margin.transfer)、借币本金(margin.loan)、借币计息(margin.interest)、归还借币本金币息(margin.repay)、其他资产变化(other)
account-idinteger账户 id
currencystring币种
typestring账户类型, 交易子账户(trade),借币子账户(loan),币息子账户(interest)
balancestring账户余额 (当订阅model=0时,该余额为可用余额;当订阅model=1时,该余额为总余额)

注:
账户更新推送的是到账金额,多笔成交产生的多笔返佣可能会合并到帐。

7) 现有v2版本账户更新订阅主题accounts.update#${mode}可推送批量返佣金额(如有)-

数据更新字段列表

字段数据类型描述
currencystring币种
accountIdlong账户ID
balancestring账户余额(仅当账户余额发生变动时推送)
availablestring可用余额(仅当可用余额发生变动时推送)
changeTypestring余额变动类型,有效值:order-place(订单创建),order-match(订单成交),order-refund(订单成交退款),order-cancel(订单撤销),order-fee-refund(点卡抵扣交易手续费),margin-transfer(杠杆账户划转),margin-loan(借币本金),margin-interest(借币计息),margin-repay(归还借币本金币息),other(其他资产变化)
accountTypestring账户类型,有效值:trade, frozen, loan, interest
changeTimelong余额变动时间,unix time in millisecond

注:
账户更新推送的是到账金额,多笔成交产生的多笔返佣可能会合并到帐。

 

对用户的影响:

API用户需自行评估此新接口上线对用户自身业务的适配,并更新相关应用。

所有变更将自本通知生效之日起更新至 Huobi API Docs