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": ""
}
}