WS / 订单/交易-更新推送

地址/future-ws/v1/user-data

说明

当有新订单创建、订单有新成交或者新的状态变化时会推送此类事件

频道名称

order

提交参数

参数名	是否必需	类型	示例	说明
op	是	string	sub	操作，sub：订阅 unsub：退订
channel	是	string	order	频道名称
token	是	string	57ba172a6be125cca2f449826f9980ca	用户令牌，请在“个人中心 - 开放接口”查看。
Nonce	是	string	1534927978_ab43c	随机数，客户端每次请求随机生成字符。生成规则，时间戳_5位随机字母或数字。如：1534927978_ab43c 注意：时间误差不能超过60秒，相同随机数只能被使用一次
Signature	是	string	v490hupi0s0bckcp6ivb69p921	签名，使用$token,$secret_key,$nonce计算得出，服务端验证签名以确定请求是否来自用户。(规则同api一样)

返回参数

参数名	是否必填	类型	示例	说明
errno	是	int	0	状态码
errmsg	是	success	success	状态信息
op	是	string	sub	操作，sub：订阅 unsub：退订
channel	是	string	order	频道名称

推送数据参数

参数名	是否必填	类型	示例	说明
channel	是	string	order	频道名
ts	是	number	1502448920	推送时间（时间戳（秒））
order	是	obj	见说明	订单信息

order参数

参数名	是否必填	类型	示例	说明
symbol	是	string	BTC-USDT	交易对
order_id	是	string	BG5000181583375122413SZXEIX	订单id
side	是	String	SELL	订单方向
order_type	是	string	LIMIT	订单类型（LIMIT:限价，MARKET ：市价，STOP_LOSS:止损单，STOP_PROFIT:止盈单，HOLD_LOSS_PROFIT:仓位止盈止损，LIMIT_LOSS_PROFIT:限价止盈止损）
quantity	是	string	20	订单原始数量，如订单内类型为：HOLD_LOSS_PROFIT，则值为ALL，表示整个仓位数量
price	是	string	68000	订单价格，市价则为空
trigger_price	否	string	70000	条件订单触发价格
event	是	string	NEW	此次事件类型（NEW:新增订单，CANCELED ：撤销订单，TRADE ：成交）
status	是	number	NEW	订单状态（NEW：挂单中，PARTIALLY_FILLED：部分成交，FILLED：完全成交，CANCELED：撤销）
amount	否	string	12	订单末次成交量
deal_amount	否	string	0.12	订单成交量（交易币个数）
last_price	否	string	68000	订单末次成交价格
last_fee	否	string	0.23	订单末次成交手续费
is_maker	否	boolean	false	是否最为挂单成交，true是，false否
ts	否	number	1502448920	成交时间（时间戳（秒））
entrust_time	是	number	1502448920	委托时间

推送示例

JSON

{
  "channel": "order",
  "ts": 1710208544,
  "order": {
    "symbol": "ETH-USDT",
    "side": "BUY",
    "amount": "",
    "deal_amount": "0.12",
    "quantity": "1",
    "last_fee": "",
    "price": "3800",
    "event": "NEW",
    "order_id": "BL2217102085443303CZQ2P",
    "order_type": "LIMIT",
    "is_maker": false,
    "status": "NEW",
    "ts": 1502448920,
    "entrust_time":1502448920,
    "last_price": ""
  }
}