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
selectPriceandapyE8must 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
| Parameter | Required | Type | Comments |
|---|---|---|---|
| category | true | string | Product type, e.g. DualAssets |
| productId | true | string | Product ID |
| orderType | true | string | Order type: Stake |
| amount | true | string | Order amount (decimal string) |
| accountType | true | string | Account type: FUND, UNIFIED |
| coin | true | string | Coin name |
| orderLinkId | true | string | User customised order ID (max 36 characters), used for idempotency |
| dualAssetsExtra | true | Object | Dual Assets specific parameters |
| > orderDirection | true | string | Direction: BuyLow, SellHigh |
| > selectPrice | true | string | Target price selected by user. Must match a valid quote |
| > apyE8 | true | int64 | Expected APY in e8 precision. Order fails if the confirmed APY is less than this value |
| interestCard | false | Object | Interest bonus card |
| > awardId | true | int64 | Interest bonus card unique ID |
| > specCode | true | string | Spec_code of the interest bonus card |
Response Parameters
| Parameter | Type | Comments |
|---|---|---|
| orderId | string | System-generated order ID |
| orderLinkId | string | User customised order ID |
Request Example
- HTTP
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
}