跳转至

WS / 订单频道

地址/ws/v1/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": ""
  }
}