跳到主要内容

下单

限速规则: 10次/秒/UID
跟单交易员限速规则:1次/秒/UID

描述

下单

HTTP请求

  • POST /api/v2/spot/trade/place-order
请求示例
curl -X POST "https://api.bitget.com/api/v2/spot/trade/place-order" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*******" \
-H "ACCESS-PASSPHRASE:*****" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json" \
-d '{"symbol": "BTCUSDT","side": "buy","orderType": "limit","force":"gtc","price":"23222.5","size":"1","clientOid":"1"}'

请求参数

参数名参数类型是否必须描述
symbolString交易对名称,如BTCUSDT
所有symbol可以通过获取交易对信息接口获取
sideString交易方向
buy:买入
sell:卖出
orderTypeString订单类型
limit:限价
market:市价
forceString执行策略(orderType为market时无效)
gtc:普通限价单,一直有效直至取消
post_only:只做 maker 订单
fok:全部成交或立即取消
ioc:立即成交并取消剩余
priceString限价价格
价格小数位、价格步长可以通过获取交易对信息接口获取
sizeString委托数量
对于Limit和Market-Sell订单,此参数表示base coin数量;
对于Market-Buy订单,此参数表示quote coin数量;
数量小数位可以通过获取交易对信息接口获取
clientOidString自定义订单ID,幂等时间为6小时,只在订单未成交时有效
tpslTypetpsl 时不生效
tpslTypeString订单类型
normal:普通单(默认值)
tpsl:止盈止损单
triggerPriceString现货止盈止损触发价格,仅限于下止盈止损订单时使用
requestTimeString请求时间, Unix毫秒时间戳格式
receiveWindowString有效窗口期,单位毫秒,最大不超过60000
如果设置此值,则请求只有在【服务器接收到请求的时间】和【请求中参与签名的时间戳】的差值在有效窗口期内才有效。
stpModeStringSTP(自成交预防)模式
none:不设置STP(默认值)
cancel_taker:取消taker单
cancel_maker:取消maker单
cancel_both:两者都取消
presetTakeProfitPriceString止盈价格
tpslTypetpsl 时不生效
价格小数位、价格步长可以通过获取交易对信息接口获取
executeTakeProfitPriceString止盈执行价格
tpslTypetpsl 时不生效
价格小数位、价格步长可以通过获取交易对信息接口获取
presetStopLossPriceString止损价格
tpslTypetpsl 时不生效
价格小数位、价格步长可以通过获取交易对信息接口获取
executeStopLossPriceString止损执行价格
tpslTypetpsl 时不生效
价格小数位、价格步长可以通过获取交易对信息接口获取
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1695808949356,
"data": {
"orderId": "121211212122",
"clientOid": "121211212122"
}
}

返回参数

返回字段参数类型字段说明
orderIdString订单ID
clientOidString自定义订单ID