Skip to main content

Place Order

API ker permission: Earn
API rate limit: 5 reqs / sec

info
  • Orders are processed asynchronously. A successful response means the order was accepted, not that it has been settled. Use Get Order List to track order status.
  • orderLinkId provides idempotency — submitting the same orderLinkId returns the same orderId without creating a duplicate order.
  • auto_invest is only applicable when category is FundPool; it is ignored for other product types.
  • Supported account types: FUND, UNIFIED.

HTTP Request

POST/v5/earn/fixed-term/place-order

Request Parameters

ParameterRequiredTypeComments
productIdtruestringProduct ID
categorytruestringProduct sub-type: FixedTermSaving, FundPool, FundPoolPremium
cointruestringCoin name, e.g. BTC, ETH
amounttruestringSubscription amount (must be > 0)
accountTypetruestringAccount type: FUND or UNIFIED
orderLinkIdtruestringUser-customised idempotent ID (max 36 characters)
autoInvestfalsebooleanEnable auto-reinvest. Only effective when category is FundPool

Response Parameters

ParameterTypeComments
orderIdstringSystem-generated order ID
orderLinkIdstringUser-customised idempotent ID

Request Example

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

{
"category": "FixedTermSaving",
"accountType": "FUND",
"amount": "201",
"coin": "USDT",
"productId": "724",
"orderLinkId": "usdt-fixdearn-001"
}

Response Example

{
"retCode": 0,
"retMsg": "",
"result": {
"orderId": "86468516-5497-4a2b-8c4c-f9c58e01e12c",
"orderLinkId": "usdt-fixdearn-001"
},
"retExtInfo": {},
"time": 1776068177658
}