跳至主要内容

下單

API key權限:Earn
API 頻率限制:每秒5次

信息
  • 訂單非同步處理。成功響應表示訂單已被接受,而非已結算。請使用取得訂單列表追蹤訂單狀態。
  • orderLinkId 提供冪等性——提交相同的 orderLinkId 會返回相同的 orderId,不會重複建立訂單。
  • autoInvest 僅在 categoryFundPool 時有效,對其他產品類型無效。
  • 支持的帳戶類型:FUNDUNIFIED

HTTP 請求

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

請求參數

參數是否必需類型說明
productIdtruestring產品ID
categorytruestring產品子類型:FixedTermSavingFundPoolFundPoolPremium
cointruestring幣種名稱,例如 BTCETH
amounttruestring訂閱金額(必須 > 0)
accountTypetruestring帳戶類型:FUNDUNIFIED
orderLinkIdtruestring用戶自訂冪等ID(最多36個字符)
autoInvestfalseboolean啟用自動續投。僅在 categoryFundPool 時有效

響應參數

參數類型說明
orderIdstring系統生成的訂單ID
orderLinkIdstring用戶自訂冪等ID

請求示例

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"
}

響應示例

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