下单频道

描述

• 单向持仓时，必须省略tradeSide参数；
  
• 双向持仓时，开多规则为：side=buy,tradeSide=open；开空规则为：side=sell,tradeSide=open；平多规则为：side=buy,tradeSide=close；平空规则为：side=sell,tradeSide=close；
• 请联系对接BD或者RM申请接入权限

请求示例

{
   "args":[
      {
         "channel":"place-order",
         "id":"xxxxx-xxx-xxx-xxxx-xxxxxx",
         "instId":"BTCUSDT",
         "instType":"USDT-FUTURES",
         "params":{
            "orderType":"limit",
            "side":"buy",
            "size":"2",
            "tradeSide":"open",
            "price":"501",
            "marginCoin":"USDT",
            "force":"gtc",
            "marginMode":"crossed",
            "clientOid":"xxxxx-xxx-xxx-xxxx-xxxxxx"
         }
      }
   ],
   "op":"trade"
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	"trade"
args	List<Object>	是	请求参数列表
> id	String	是	用户标识请求与返回 长度<= 40 ("^[0-9A-Za-z_:#\-+\s]*$");
> instType	String	是	产品类型 USDT-FUTURES
> instId	String	是	产品ID, 例如：ETHUSDT
> channel	String	是	频道名, place-order
> params	Object	是
>> orderType	String	是	订单类型 limit: 限价 market: 市价
>> side	String	是	交易方向 buy: 单向持仓时代表买入，双向持仓时代表多头方向 sell: 单向持仓时代表卖出，双向持仓时代表空头方向
>> size	String	是	下单数量(基础币) 数量小数位可以通过获取合约信息 接口获取
>> force	String	是	订单有效期 gtc：普通限价单，一直有效直至取消 post_only：只做 maker 订单 fok：全部成交或立即取消 ioc：立即成交并取消剩余 orderType为limit限价单时必填，若省略则默认为gtc
>> price	String	否	下单价格 orderType为limit时必填 价格小数位可以通过获取合约信息 接口获取
>> clientOid	String	否	自定义订单ID
>> marginCoin	String	是	保证金币种(大写), 如:USDT
>> marginMode	String	是	仓位模式 isolated: 逐仓 crossed: 全仓
>> tradeSide	String	否	交易类型(仅限双向持仓) 双向持仓模式下必填，单向持仓时不要填，否则会报错 open: 开仓 close: 平仓
>> reduceOnly	String	否	只减仓(仅适用单向持仓模式下) YES NO(默认)
>> presetStopSurplusPrice	String	否	预设止盈值 为空则默认不设止盈
>> presetStopLossPrice	String	否	预设止损值 为空则默认不设止损
>> stpMode	String	否	STP（自成交预防）模式 none：不设置STP（默认值） cancel_taker：取消taker单 cancel_maker：取消maker单 cancel_both：两者都取消

响应示例

{
  "event":"trade",
  "arg":[
    {
      "id":"xxxxx-xxx-xxx-xxxx-xxxxxx",
      "instType":"USDT-FUTURES",
      "channel":"place-order",
      "instId":"BTCUSDT",
      "params":{
        "orderId":"xxxxxxxxxxx",
        "clientOid":"xxxxx-xxx-xxx-xxxx-xxxxxx"
      }
    }
  ],
  "code":0,
  "msg":"Success"
}

响应参数

返回字段	参数类型	字段说明
event	String	事件 trade 交易 error参数错误
arg	Object	订阅成功的频道
> id	String	用户标识请求与返回 长度<= 40 ("^[0-9A-Za-z_:#\-+\s]*$");
> instType	String	产品类型 USDT-FUTURES
> instId	String	产品ID, 例如：ETHUSDT
> channel	String	频道名, place-order
> params	Object
>> orderId	String	订单ID
>> clientOid	String	自定义订单ID
>> orderType	String	订单类型 limit: 限价 market: 市价
>> side	String	交易方向 buy: 单向持仓时代表买入，双向持仓时代表多头方向 sell: 单向持仓时代表卖出，双向持仓时代表空头方向
>> size	String	下单数量(基础币) 数量小数位可以通过获取合约信息 接口获取
>> force	String	订单有效期 gtc：普通限价单，一直有效直至取消 post_only：只做 maker 订单 fok：全部成交或立即取消 ioc：立即成交并取消剩余 orderType为limit限价单时必填，若省略则默认为gtc
>> price	String	下单价格 orderType为limit时必填 价格小数位可以通过获取合约信息 接口获取
>> marginCoin	String	保证金币种(大写), 如:USDT
>> marginMode	String	仓位模式 isolated: 逐仓 crossed: 全仓
>> tradeSide	String	交易类型(仅限双向持仓) 双向持仓模式下必填，单向持仓时不要填，否则会报错 open: 开仓 close: 平仓
>> reduceOnly	String	只减仓(仅适用单向持仓模式下) YES NO(默认)
>> presetStopSurplusPrice	String	预设止盈值 为空则默认不设止盈
>> presetStopLossPrice	String	预设止损值 为空则默认不设止损
>> stpMode	String	STP（自成交预防）模式 none：不设置STP（默认值） cancel_taker：取消taker单 cancel_maker：取消maker单 cancel_both：两者都取消
code	String	状态码
msg	String	状态消息