Skip to main content

Place Order

info
  • Requires Earn permission on the API key.
  • The order is processed asynchronously. A successful response means the order has been accepted, not settled. Use Get Order Info to track the order status (PendingSuccess).
  • orderLinkId is used for idempotency — resubmitting the same orderLinkId within 30 minutes returns the same orderId without creating a duplicate order.
  • Stake: must pass doubleWinStakeExtra. For fixed range products, use the leverage from Get Fixed Product Quote. For RFQ products, use the leverage from Get Custom Product Quote and include lowerPrice / upperPrice. The order must be placed before the quote's expireTime.
  • Redeem: must call Get Redeem Estimated Amount first to obtain estRedeemAmount, then pass it in doubleWinRedeemExtra.

HTTP Request

POST/v5/earn/advance/place-order

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct category. DoubleWin
productIdtruestringProduct ID
orderTypetruestringStake: subscribe; Redeem: early redemption
amountfalsestringOrder amount. Required for Stake
accountTypetruestringAccount type: FUND or UNIFIED. Not required for Redeem
cointruestringCoin name, e.g. USDT. Not required for Redeem
orderLinkIdtruestringUser customised order ID (max 64 characters, alphanumeric and _-), used for idempotency
doubleWinStakeExtrafalseObjectRequired when orderType=Stake
> leveragetruestringLeverage multiplier obtained from Get Fixed Product Quote or Get Custom Product Quote. Maximum 2 decimal places, must not exceed the quoted maximum
> initialPricetruestringCurrent index price of the underlying asset at order time. Recommend using currentPrice from Get Fixed Product Quote
> lowerPricefalsestringRFQ only. Custom lower bound of price range. Must match the value used in Get Custom Product Quote
> upperPricefalsestringRFQ only. Custom upper bound of price range. Must match the value used in Get Custom Product Quote
doubleWinRedeemExtrafalseObjectRequired when orderType=Redeem
> positionIdtruestringPosition ID to redeem, obtained from Get Position Info
> estRedeemAmounttruestringEstimated redeem amount from Get Redeem Estimated Amount
> isSlippageProtectedfalseboolWhether to enable slippage protection. Default: false. If enabled, the order fails when the actual redeem amount deviates significantly from estRedeemAmount

Response Parameters

ParameterTypeComments
orderIdstringSystem-generated order ID
orderLinkIdstringUser customised order ID

Request Example

Stake (Fixed Range)

POST /v5/earn/advance/place-order HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672211928338
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"category": "DoubleWin",
"productId": "14084",
"coin": "USDT",
"amount": "150",
"orderType": "Stake",
"accountType": "FUND",
"orderLinkId": "usdt-earn-009",
"doubleWinStakeExtra": {
"initialPrice": "66445.69",
"leverage": "9"
}
}

Stake (RFQ Custom Range)

POST /v5/earn/advance/place-order HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672211928338
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"category": "DoubleWin",
"productId": "14084",
"coin": "USDT",
"amount": "150",
"orderType": "Stake",
"accountType": "FUND",
"orderLinkId": "usdt-earn-009",
"doubleWinStakeExtra": {
"initialPrice": "66445.69",
"leverage": "9"
}
}

Redeem

POST /v5/earn/advance/place-order HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672211928338
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"category": "DoubleWin",
"productId": "14092",
"coin": "USDT",
"amount": "200",
"orderType": "Stake",
"accountType": "FUND",
"orderLinkId": "usdt-earn-010",
"doubleWinStakeExtra": {
"initialPrice": "66333.94",
"lowerPrice": "63000",
"upperPrice": "70000",
"leverage": "245.18"
}
}

Response Example

{
"retCode": 0,
"retMsg": "",
"result": {
"orderId": "05184c23-8a98-456c-a2af-0ef1c45116cc",
"orderLinkId": "usdt-earn-009"
},
"retExtInfo": {},
"time": 1775107011430
}