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

下单频道

描述

  • 单向持仓时,必须省略tradeSide参数;
  • 双向持仓时,开多规则为:side=buy,tradeSide=open;开空规则为:side=sell,tradeSide=open;平多规则为:side=buy,tradeSide=close;平空规则为:side=sell,tradeSide=close;
Code
{ "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" }

请求参数

参数名参数类型是否必须描述
opString是"trade"
apiCodeString否API返佣标识
argsList<Object>是请求参数列表
> idString是用户标识请求与返回
长度<= 40
("^[0-9A-Za-z_:#\-+\s]*$");
> instTypeString是产品类型 USDT-FUTURES
> instIdString是产品ID, 例如:ETHUSDT
> channelString是频道名, place-order
> paramsObject是
>> orderTypeString是订单类型
limit: 限价
market: 市价
>> sideString是交易方向
buy: 单向持仓时代表买入,双向持仓时代表多头方向
sell: 单向持仓时代表卖出,双向持仓时代表空头方向
>> sizeString是下单数量(基础币)
数量小数位可以通过获取合约信息 接口获取
>> forceString是订单有效期
gtc:普通限价单,一直有效直至取消
post_only:只做 maker 订单
fok:全部成交或立即取消
ioc:立即成交并取消剩余
orderType为limit限价单时必填,若省略则默认为gtc
>> priceString否下单价格
orderType为limit时必填
价格小数位可以通过获取合约信息 接口获取
>> clientOidString否自定义订单ID
>> marginCoinString是保证金币种(大写), 如
>> marginModeString是仓位模式
isolated: 逐仓
crossed: 全仓
>> tradeSideString否交易类型(仅限双向持仓)
双向持仓模式下必填,单向持仓时不要填,否则会报错
open: 开仓
close: 平仓
>> reduceOnlyString否只减仓(仅适用单向持仓模式下)
YES
NO(默认)
>> presetStopSurplusPriceString否预设止盈值
为空则默认不设止盈
>> presetStopLossPriceString否预设止损值
为空则默认不设止损
>> stpModeString否STP(自成交预防)模式
none:不设置STP(默认值)
cancel_taker:取消taker单
cancel_maker:取消maker单
cancel_both:两者都取消
Code
{ "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" }

响应参数

返回字段参数类型字段说明
eventString事件
trade 交易
error参数错误
argObject订阅成功的频道
> idString用户标识请求与返回
长度<= 40
("^[0-9A-Za-z_:#\-+\s]*$");
> instTypeString产品类型 USDT-FUTURES
> instIdString产品ID, 例如:ETHUSDT
> channelString频道名, place-order
> paramsObject
>> orderIdString订单ID
>> clientOidString自定义订单ID
>> orderTypeString订单类型
limit: 限价
market: 市价
>> sideString交易方向
buy: 单向持仓时代表买入,双向持仓时代表多头方向
sell: 单向持仓时代表卖出,双向持仓时代表空头方向
>> sizeString下单数量(基础币)
数量小数位可以通过获取合约信息 接口获取
>> forceString订单有效期
gtc:普通限价单,一直有效直至取消
post_only:只做 maker 订单
fok:全部成交或立即取消
ioc:立即成交并取消剩余
orderType为limit限价单时必填,若省略则默认为gtc
>> priceString下单价格
orderType为limit时必填
价格小数位可以通过获取合约信息 接口获取
>> marginCoinString保证金币种(大写), 如
>> marginModeString仓位模式
isolated: 逐仓
crossed: 全仓
>> tradeSideString交易类型(仅限双向持仓)
双向持仓模式下必填,单向持仓时不要填,否则会报错
open: 开仓
close: 平仓
>> reduceOnlyString只减仓(仅适用单向持仓模式下)
YES
NO(默认)
>> presetStopSurplusPriceString预设止盈值
为空则默认不设止盈
>> presetStopLossPriceString预设止损值
为空则默认不设止损
>> stpModeStringSTP(自成交预防)模式
none:不设置STP(默认值)
cancel_taker:取消taker单
cancel_maker:取消maker单
cancel_both:两者都取消
codeString状态码
msgString状态消息
撤销订单频道ADL通知
JSON
JSON