Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
Websocket
介绍
合约
现货
    公共频道
    私有频道
      账户频道成交明细订单频道计划委托频道下单频道撤销订单频道
杠杆
私有频道

下单频道

描述

1.限频与Rest API共享
2.使用时请求连接V2的websocket域名 wss://ws.bitget.com/v2/ws/private
3.暂时不支持批量下单,每次请求仅限一单

Code
{ "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" } } ] }

请求参数

参数名参数类型是否必须描述
opString是"trade"
apiCodeString否API返佣标识
argsList<Object>是请求参数列表
> idString是用户标识请求与返回
长度<= 40
("^[0-9A-Za-z_:#\-+\s]*$");
> instTypeString是产品类型 SPOT
> instIdString是产品ID, 例如:ETHUSDT
> channelString是频道名, place-order
> paramsObject是
>> orderTypeString是订单类型
limit: 限价
market: 市价
>> sideString是订单方向
buy: 买
sell: 卖
>> sizeString是数量
对于Limit和Market-Sell订单,此参数表示base coin数量;
对于Market-Buy订单,此参数表示quote coin数量;
数量小数位可以通过获取交易对信息接口获取
>> forceString是执行策略(orderType为market时无效)
gtc:普通限价单,一直有效直至取消
post_only:只做 maker 订单
fok:全部成交或立即取消
ioc:立即成交并取消剩余
>> priceString否限价价格
价格小数位、价格步长可以通过获取交易对信息接口获取
>> clientOidString否自定义订单ID
>> stpModeString否STP(自成交预防)模式
none:不设置STP(默认值)
cancel_taker:取消taker单
cancel_maker:取消maker单
cancel_both:两者都取消
Code
{ "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" }

响应参数

返回字段参数类型字段说明
eventString事件
trade 交易
error参数错误
argObject订阅成功的频道
> idString用户标识请求与返回
长度<= 40
("^[0-9A-Za-z_:#\-+\s]*$");
> instTypeString产品类型 SPOT
> instIdString产品ID, 例如:ETHUSDT
> channelString频道名, place-order
> paramsObject
>> orderIdString订单ID.
>> orderTypeString订单类型
limit: 限价
market: 市价
>> sideString订单方向
buy: 买
sell: 卖
>> sizeString数量
对于Limit和Market-Sell订单,此参数表示base coin数量;
对于Market-Buy订单,此参数表示quote coin数量;
数量小数位可以通过获取交易对信息接口获取
>> forceString执行策略(orderType为market时无效)
gtc:普通限价单,一直有效直至取消
post_only:只做 maker 订单
fok:全部成交或立即取消
ioc:立即成交并取消剩余
>> priceString限价价格
价格小数位、价格步长可以通过获取交易对信息接口获取
>> clientOidString自定义订单ID
>> stpModeStringSTP(自成交预防)模式
none:不设置STP(默认值)
cancel_taker:取消taker单
cancel_maker:取消maker单
cancel_both:两者都取消
codeString状态码
msgString状态消息
计划委托频道撤销订单频道
JSON
JSON