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.
orderLinkIdprovides idempotency — submitting the sameorderLinkIdreturns the sameorderIdwithout creating a duplicate order.auto_investis only applicable whencategoryisFundPool; it is ignored for other product types.- Supported account types:
FUND,UNIFIED.
HTTP Request
POST/v5/earn/fixed-term/place-orderRequest Parameters
| Parameter | Required | Type | Comments |
|---|---|---|---|
| productId | true | string | Product ID |
| category | true | string | Product sub-type: FixedTermSaving, FundPool, FundPoolPremium |
| coin | true | string | Coin name, e.g. BTC, ETH |
| amount | true | string | Subscription amount (must be > 0) |
| accountType | true | string | Account type: FUND or UNIFIED |
| orderLinkId | true | string | User-customised idempotent ID (max 36 characters) |
| autoInvest | false | boolean | Enable auto-reinvest. Only effective when category is FundPool |
Response Parameters
| Parameter | Type | Comments |
|---|---|---|
| orderId | string | System-generated order ID |
| orderLinkId | string | User-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
}