跳转至

WS / 订单频道

地址/ws/v1/spot/order

频道名称

order

提交参数

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

提交示例

JSON
{
  "op":"sub",
  "channel": "order",
  "token": "57ba172a6be125cca2f449826f9980ca",
  "Nonce": "1534927978_ab43c",
  "Signature": "v490hupi0s0bckcp6ivb69p921"
}

推送数据参数

参数名 是否必填 类型 示例 说明
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 :市价)
amount 是 string 20 订单原始数量, 市价买时为成交额
entrust_time 是 number 20 委托时间
price 是 string 68000 订单价格,市价则为空
trigger_price 否 string 70000 条件订单触发价格
event 是 string NEW 此次事件类型(NEW:新增订单,CANCELED :撤销订单,TRADE :成交)
status 是 number NEW 订单状态(NEW:挂单中,PARTIALLY_FILLED:部分成交,FILLED:完全成交,PARTIALLY_CANCELED:部分撤销,CANCELED:撤销)
last_amount 否 string 12 订单末次成交量
last_price 否 string 68000 订单末次成交价格
last_fee 否 string 0.23 订单末次成交手续费
ts 否 number 1502448920 成交时间(时间戳(秒))

返回示例

JSON
{
  "channel": "order",
  "ts": 1710208544,
  "order": {
    "symbol": "ETH-USDT",
    "side": "BUY",
    "amount": "",
    "last_price": "",
    "last_fee": "",
    "last_amount": "",
    "price": "3800",
    "event": "NEW",
    "order_id": "BL2217102085443303CZQ2P",
    "order_type": "LIMIT",
    "is_maker": false,
    "status": "NEW",
    "ts": ""
  }
}