# 下单频道
### 描述
- 单向持仓时，必须省略`tradeSide`参数；
- 双向持仓时，开多规则为：`side=buy,tradeSide=open`；开空规则为：`side=sell,tradeSide=open`；平多规则为：`side=buy,tradeSide=close`；平空规则为：`side=sell,tradeSide=close`；
```json title="请求示例"
{
"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" |
| apiCode | String | 否 | API返佣标识 |
| 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`：两者都取消 |
```json title="响应示例"
{
"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 | 状态消息 |