# 下单频道
### 描述
1.限频与Rest API共享
2.使用时请求连接V2的websocket域名 wss://ws.bitget.com/v2/ws/private
3.暂时不支持批量下单，每次请求仅限一单
```json title="请求示例"
{
"op":"trade",
"args":[
{
"id":"xxxxx-xxx-xxx-xxxx-xxxxxx",
"instType":"SPOT",
"instId":"BTCUSDT",
"channel":"place-order",
"params":{
"orderType":"limit",
"side":"buy",
"size":"1",
"price":"252",
"force":"gtc",
"clientOid":"xxxxx-xxx-xxx-xxxx-xxxxxx"
}
}
]
}
```
### 请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|:-------------------|:-------------------|:-----|:-----------------------------------------------------------------------------------------------------------------------|
| op | String | 是 | "trade" |
| apiCode | String | 否 | API返佣标识 |
| args | List<Object> | 是 | 请求参数列表 |
| > id | String | 是 | 用户标识请求与返回
长度<= 40
("^[0-9A-Za-z_:#\\-+\\s]*$"); |
| > instType | String | 是 | 产品类型 `SPOT` |
| > instId | String | 是 | 产品ID, 例如：`ETHUSDT` |
| > channel | String | 是 | 频道名, `place-order` |
| > params | Object | 是 | |
| >> orderType | String | 是 | 订单类型
`limit`: 限价
`market`: 市价 |
| >> side | String | 是 | 订单方向
`buy`: 买
`sell`: 卖 |
| >> size | String | 是 | 数量
对于Limit和Market-Sell订单，此参数表示base coin数量;
对于Market-Buy订单，此参数表示quote coin数量；
数量小数位可以通过获取交易对信息接口获取 |
| >> force | String | 是 | 执行策略（orderType为market时无效）
`gtc`：普通限价单，一直有效直至取消
`post_only`：只做 maker 订单
`fok`：全部成交或立即取消
`ioc`：立即成交并取消剩余 |
| >> price | String | 否 | 限价价格
价格小数位、价格步长可以通过获取交易对信息接口获取 |
| >> clientOid | String | 否 | 自定义订单ID |
| >> 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":"SPOT",
"channel":"place-order",
"instId":"BTCUSDT",
"params":{
"orderId":"xxxxxxxx",
"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 | 产品类型 `SPOT` |
| > instId | String | 产品ID, 例如：`ETHUSDT` |
| > channel | String | 频道名, `place-order` |
| > params | Object | |
| >> orderId | String | 订单ID. |
| >> orderType | String | 订单类型
`limit`: 限价
`market`: 市价 |
| >> side | String | 订单方向
`buy`: 买
`sell`: 卖 |
| >> size | String | 数量
对于Limit和Market-Sell订单，此参数表示base coin数量;
对于Market-Buy订单，此参数表示quote coin数量；
数量小数位可以通过获取交易对信息接口获取 |
| >> force | String | 执行策略（orderType为market时无效）
`gtc`：普通限价单，一直有效直至取消
`post_only`：只做 maker 订单
`fok`：全部成交或立即取消
`ioc`：立即成交并取消剩余 |
| >> price | String | 限价价格
价格小数位、价格步长可以通过获取交易对信息接口获取 |
| >> clientOid | String | 自定义订单ID |
| >> stpMode | String | STP（自成交预防）模式
`none`：不设置STP（默认值）
`cancel_taker`：取消taker单
`cancel_maker`：取消maker单
`cancel_both`：两者都取消 |
| code | String | 状态码 |
| msg | String | 状态消息 |