Skip to main content

Place Order

info
  • Need authentication. Up to 5 requests per second.
  • 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 (Pending → Success).
  • The selectPrice and apyE8 must match a valid quote from Get Product Quote or the WebSocket channel. Stale quotes will be rejected.
  • orderLinkId is used for idempotency — resubmitting the same orderLinkId within 30 minutes returns the same orderId without creating a duplicate order.

HTTP Request

POST /v5/order/advance/place-order

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct type, e.g. DualAssets
productIdtruestringProduct ID
orderTypetruestringOrder type: Stake
amounttruestringOrder amount (decimal string)
accountTypetruestringAccount type: FUND, UNIFIED
cointruestringCoin name
orderLinkIdtruestringUser customised order ID (max 36 characters), used for idempotency
dualAssetsExtratrueObjectDual Assets specific parameters
> orderDirectiontruestringDirection: BuyLow, SellHigh
> selectPricetruestringTarget price selected by user. Must match a valid quote
> apyE8trueint64Expected APY in e8 precision. Order fails if the confirmed APY is less than this value
interestCardfalseObjectInterest bonus card
> awardIdtrueint64Interest bonus card unique ID
> specCodetruestringSpec_code of the interest bonus card

Response Parameters

ParameterTypeComments
orderIdstringSystem-generated order ID
orderLinkIdstringUser customised order ID

Request Example

POST /v5/order/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": "DualAssets",
"productId": 36320,
"orderType": "Stake",
"amount": "20",
"accountType": "UNIFIED",
"coin": "USDT",
"orderLinkId": "54b3589b-da55-4b17-acdd-aa75912c9eb",
"dualAssetsExtra": {
"orderDirection": "BuyLow",
"selectPrice": "2325",
"apyE8": 857565000
}
}

Response Example

{
"retCode": 0,
"retMsg": "",
"result": {
"orderId": "97f198e9-b14b-4703-b4a6-a4aa06ba1499",
"orderLinkId": "54b3589b-da55-4b17-acdd-aa75912c9eb"
},
"retExtInfo": {},
"time": 1773815412459
}