下单

普通用户:限速10次/秒，根据uid限频
跟单带单员:限速1次/秒，根据uid限频

描述

单向持仓时，必须省略tradeSide参数；
双向持仓时，开多规则为：side=buy,tradeSide=open；开空规则为：side=sell,tradeSide=open；平多规则为：side=buy,tradeSide=close；平空规则为：side=sell,tradeSide=close
双向持仓时，如果有限价平仓单占用仓位，此时再下的市价平仓单的数量与限价单平仓的数量超过仓位数量时会报仓位不足错误，而不会取消已占用仓位的限价单。例如：仓位数量100，限价单占用70，此时再下50数量的市价单平仓时会报错仓位不足，而不是取消占用仓位的限价单执行市价单。

HTTP请求

POST /api/v2/mix/order/place-order

请求示例
curl -X POST "https://api.bitget.com/api/v2/mix/order/place-order" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" \
  -d '{ "symbol": "ETHUSDT", "productType": "USDT-FUTURES", "marginMode": "isolated", "marginCoin": "USDT", "size": "0.1", "price": "2000", "side": "sell", "tradeSide": "open", "orderType": "limit", "force": "gtc", "clientOid": "121211212122" }'

请求参数

参数名	参数类型	是否必须	描述
symbol	String	是	交易对名称如:"ETHUSDT"
productType	String	是	产品类型 `USDT-FUTURES` USDT专业合约 `COIN-FUTURES` 混合合约 `USDC-FUTURES` USDC专业合约 `SUSDT-FUTURES` USDT专业合约模拟盘 `SCOIN-FUTURES` 混合合约模拟盘 `SUSDC-FUTURES` USDC专业合约模拟盘
marginMode	String	是	仓位模式 `isolated`: 逐仓 `crossed`: 全仓
marginCoin	String	是	保证金币种(大写), 如:USDT
size	String	是	下单数量(基础币) 数量小数位可以通过获取合约信息接口获取
price	String	否	下单价格。 orderType为`limit`时必填价格小数位可以通过获取合约信息接口获取
side	String	是	交易方向 `buy`: 单向持仓时代表买入，双向持仓时代表多头方向 `sell`: 单向持仓时代表卖出，双向持仓时代表空头方向
tradeSide	String	否	交易类型(仅限双向持仓) 双向持仓模式下必填，单向持仓时不要填，否则会报错 `open`: 开仓 `close`: 平仓
orderType	String	是	订单类型 `limit`: 限价单， `market`: 市价单
force	String	否	订单有效期 `ioc`: 无法立即成交的部分就撤销 `fok`: 无法全部立即成交就撤销 `gtc`: 普通订单, 订单会一直有效，直到被成交或者取消 `post_only`: 只做maker "orderType"为`limit`限价单时必填，若省略则默认为`gtc`
clientOid	String	否	自定义订单id, 幂等时间为20分钟
reduceOnly	String	否	只减仓(仅适用单向持仓模式下) `YES` `NO`(默认)
presetStopSurplusPrice	String	否	预设止盈值为空则默认不设止盈。
presetStopLossPrice	String	否	预设止损值为空则默认不设止损。
stpMode	String	否	STP模式（自成交预防） `none`：不设置STP（默认值） `cancel_taker`：取消taker单 `cancel_maker`：取消maker单 `cancel_both`：两者都取消

返回示例
{
    "code": "00000",
    "msg": "success",
    "requestTime": 1695806875837,
    "data": {
        "clientOid": "121211212122",
        "orderId": "121211212122"
    }
}

返回参数

返回字段	参数类型	字段说明
orderId	String	订单id
clientOid	String	自定义订单id

下单

描述​

HTTP请求​

请求参数​

返回参数​

您的阅读体验如何？

描述

HTTP请求

请求参数

返回参数