下单频道
描述
1.限频与Rest API共享
2.使用时请求连接V2的websocket域名 wss://ws.bitget.com/v2/ws/private
3.暂时不支持批量下单,每次请求仅限一单
4.请联系对接BD或者RM申请接入权限
请求示例
{
"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" |
| 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:两者都取消 |
响应示例
{
"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 | 状态消息 |