Skip to main content

Place Order

Rate limit: 10 requests/second/UID
Rate limit: 1 request/second/UID for copy trading traders

Description

Place Order

HTTP Request

  • POST /api/v2/spot/trade/place-order
Request Example
curl -X POST "https://api.bitget.com/api/v2/spot/trade/place-order" \
-H "ACCESS-KEY:your apiKey" \
-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":"121211212122"}'

Request Parameter

ParameterTypeRequiredDescription
symbolStringYesTrading pair name, e.g. BTCUSDT
All symbols can be returned by Get Symbol Info interface
sideStringYesOrder Direction
buy: Buy
sell: Sell
orderTypeStringYesOrder type
limit: Limit order
market: Market order
forceStringYesExecution strategy(It is invalid when orderType is market)
gtc: Normal limit order, good till cancelled
post_only: Post only
fok: Fill or kill
ioc: Immediate or cancel
priceStringNoLimit price
The decimal places of price and the price step can be returned by the Get Symbol Info interface
sizeStringYesAmount
For Limit and Market-Sell orders, it represents the number of base coins.
For Market-Buy orders, it represents the number of quote coins.
The decimal places of amount can be got trough Get Symbol Info interface
clientOidStringNoCustomed order ID. The idempotency time is 6 hours, only valid when orders are unfilled.
It's invalid when tpslType is tpsl
triggerPriceStringNoSPOT TP/SL trigger price, only requried in SPOT TP/SL order
tpslTypeStringNoOrder type
normal:SPOT order(default)
tpsl:SPOT TP/SL order
requestTimeStringNoRequest Time, Unix millisecond timestamp
receiveWindowStringNoValid time window, Unix millisecond timestamp
If it's set, the request is valid only when the time range between the timestamp in the request and the time that server received the request is within receiveWindow
stpModeStringNoSTP Mode(Self Trade Prevention)
none: not setting STP(default)
cancel_taker: cancel taker order
cancel_maker: cancel maker order
cancel_both: cancel both of taker and maker orders
presetTakeProfitPriceStringNoTake profit price
It's invalid when tpslType is tpsl
The decimal places of price and the price step can be returned by the Get Symbol Info interface
executeTakeProfitPriceStringNoTake profit execute price
It's invalid when tpslType is tpsl
The decimal places of price and the price step can be returned by the Get Symbol Info interface
presetStopLossPriceStringNoStop loss price
It's invalid when tpslType is tpsl
The decimal places of price and the price step can be returned by the Get Symbol Info interface
executeStopLossPriceStringNoStop loss execute price
It's invalid when tpslType is tpsl
The decimal places of price and the price step can be returned by the Get Symbol Info interface
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1695808949356,
"data": {
"orderId": "1001",
"clientOid": "121211212122"
}
}

Response Parameter

ParameterTypeDescription
orderIdStringOrder ID
clientOidStringCustom order ID

How was your Reading Experience with us?