订单频道

描述

订阅订单频道

以下事件发生时推送数据：

下开/平仓委托
开/平仓委托成交
撤单

请求示例
{
    "op": "subscribe",
    "args": [
        {
            "instType": "USDT-FUTURES",
            "channel": "orders",
            "instId": "default"
        }
    ]
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作, subscribe unsubscribe
args	List<Object>	是	请求订阅的频道列表
> channel	String	是	频道名
> instType	String	是	产品类型 `USDT-FUTURES` USDT专业合约 `COIN-FUTURES` 混合合约 `USDC-FUTURES` USDC专业合约 `SUSDT-FUTURES` USDT专业合约模拟盘 `SCOIN-FUTURES` 混合合约模拟盘 `SUSDC-FUTURES` USDC专业合约模拟盘
> instId	String	否	交易对，如BTCUSDT `defalut`代表订阅所有交易对交割合约只支持`default`

订阅返回示例
{
    "event": "subscribe",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "orders",
        "instId": "default"
    }
}

返回参数

返回字段	参数类型	字段说明
event	String	事件
arg	Object	订阅的频道
> channel	String	频道名
> instType	String	产品类型 `USDT-FUTURES` USDT专业合约 `COIN-FUTURES` 混合合约 `USDC-FUTURES` USDC专业合约 `SUSDT-FUTURES` USDT专业合约模拟盘 `SCOIN-FUTURES` 混合合约模拟盘 `SUSDC-FUTURES` USDC专业合约模拟盘
> instId	String	产品id
code	String	错误码
msg	String	错误消息

推送返回示例
{
    "action": "snapshot",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "orders",
        "instId": "default"
    },
    "data": [
        {
            "accBaseVolume": "0.01",
            "cTime": "1695718781129",
            "clientOId": "1",
            "feeDetail": [
                {
                    "feeCoin": "USDT",
                    "fee": "-0.162003"
                }
            ],
            "fillFee": "-0.162003",
            "fillFeeCoin": "USDT",
            "fillNotionalUsd": "270.005",
            "fillPrice": "27000.5",
            "baseVolume": "0.01",
            "stpMode":"cancel_taker",
            "fillTime": "1695718781146",
            "force": "gtc",
            "instId": "BTCUSDT",
            "leverage": "20",
            "marginCoin": "USDT",
            "marginMode": "crossed",
            "notionalUsd": "270",
            "orderId": "1",
            "orderType": "market",
            "pnl": "0",
            "posMode": "hedge_mode",
            "posSide": "long",
            "price": "0",
            "priceAvg": "27000.5",
            "reduceOnly": "no",
            "side": "buy",
            "size": "0.01",
            "enterPointSource": "WEB",
            "status": "filled",
            "tradeScope": "T",
            "tradeId": "1111111111",
            "tradeSide": "open",
            "presetStopSurplusPrice": "21.4",
            "totalProfits": "11221.45",
            "presetStopLossPrice": "21.5",
            "uTime": "1695718781146"
        }
    ],
    "ts": 1695718781206
}

推送数据参数

返回字段	参数类型	字段说明
action	String	推送动作, `snapshot` or `update`
arg	Object	订阅成功的频道
> channel	String	频道名
> instType	String	产品类型 `USDT-FUTURES` USDT专业合约 `COIN-FUTURES` 混合合约 `USDC-FUTURES` USDC专业合约 `SUSDT-FUTURES` USDT专业合约模拟盘 `SCOIN-FUTURES` 混合合约模拟盘 `SUSDC-FUTURES` USDC专业合约模拟盘
> instId	String	产品ID
data	List<Object>	订阅的数据
> orderId	String	订单ID
> clientOId	String	自定义订单id
> price	String	委托价格
> size	String	原始委托数量，以币为单位
> posMode	String	持仓模式 `one_way_mode`：单向持仓 `hedge-mode`: 双向持仓
> enterPointSource	String	订单来源 WEB WEB客户端 IOS IOS客户端 ANDROID Andriod客户端 API API客户端 SYS 系统, 通常为爆仓
> tradeSide	String	交易方向
> notionalUsd	String	委托单预估美元价值
> orderType	String	订单类型 limit 限价单， market 市价单
> force	String	订单有效期
> side	String	订单方向
> posSide	String	持仓方向 `long`: 双向持仓多头 `short`: 双向持仓空头 `net`: 单向持仓
> marginMode	String	交易模式保证金模式 `crossed`: 全仓 `isolated`: 逐仓
> marginCoin	String	保证金币种
> fillPrice	String	最新成交价格
> tradeId	String	最新成交ID
> baseVolume	String	最新成交数量
> fillTime	String	最新成交时间, Unix毫秒时间戳，例如1690196141868
> fillFee	String	最新一笔成交的手续费, 负数
> fillFeeCoin	String	最新一笔成交的手续费币种
> tradeScope	String	最新一笔成交的流动性方向 `T`：taker `M`：maker
> accBaseVolume	String	累计成交数量
> fillNotionalUsd	String	委托单已成交的美元价值
> priceAvg	String	成交均价如果成交数量为0，该字段为0；若未成交，该字段也为0；取消订单不会推送此字段
> status	String	订单状态 live 新建订单，orderbook中等待撮合 partially_filled 部分成交 filled 全部成交 canceled 已撤销
> leverage	String	杠杆倍数
> feeDetail	List<Object>	订单手续费
>> feeCoin	String	交易手续费币种收取的就是保证金
>> fee	String	订单交易手续费，平台向用户收取的交易手续费
> pnl	String	收益
> uTime	String	订单更新时间，Unix时间戳的毫秒数格式，如 1597026383085
> cTime	String	订单创建时间，Unix时间戳的毫秒数格式，如 1597026383085
> reduceOnly	String	是否只减仓 `yes`: 是 `no`: 否
> presetStopSurplusPrice	String	预设止盈价格
> presetStopLossPrice	String	预设止损价格
> totalProfits	String	总盈亏
> stpMode	String	STP模式 `none` 不设置STP `cancel_taker` 取消taker单 `cancel_maker` 取消maker单 `cancel_both` 两者都取消

订单频道

描述​

请求参数​

返回参数​

推送数据参数​

您的阅读体验如何？

描述

请求参数

返回参数

推送数据参数