創建訂單

信息

• API 金鑰需要具備 Earn（理財）權限。
• 訂單採非同步處理。響應成功僅代表訂單已被接受，而非已結算。請使用查詢訂單資訊來追蹤訂單狀態（Pending → Success）。
• orderLinkId 用於保證冪等性——在 30 分鐘內重複提交相同的 orderLinkId，將返回相同的 orderId，而不會創建重複訂單。
• 申購（Stake）：必須傳入 doubleWinStakeExtra。固定區間產品請使用查詢固定產品報價中的 leverage；RFQ 產品請使用查詢自選區間產品報價中的 leverage，並傳入 lowerPrice 和 upperPrice。須在報價的 expireTime 前完成下單。
• 贖回（Redeem）：必須先調用查詢贖回預估金額獲取 estRedeemAmount，再透過 doubleWinRedeemExtra 傳入。

HTTP 請求

POST/v5/earn/advance/place-order

請求參數

參數	必填	類型	說明
category	true	string	產品類別，DoubleWin
productId	true	string	產品 ID
orderType	true	string	訂單類型：Stake（申購），Redeem（提前贖回）
amount	false	string	訂單金額。Stake 訂單必填
accountType	true	string	帳戶類型：FUND（資金帳戶），UNIFIED（統一帳戶）。Redeem 訂單無需填寫
coin	true	string	幣種名稱，例如：USDT。Redeem 訂單無需填寫
orderLinkId	true	string	用戶自定義訂單 ID（最多 64 個字元，支援英數字及 _-），用於冪等性控制
doubleWinStakeExtra	false	Object	orderType=Stake 時必填
> leverage	true	string	槓桿倍數，從查詢固定產品報價或查詢自選區間產品報價獲取。最多 2 位小數，不可超過報價返回的最大值
> initialPrice	true	string	下單時的標的資產指數價格。建議使用查詢固定產品報價返回的 currentPrice
> lowerPrice	false	string	僅 RFQ 產品需填寫。 自選價格區間下限，須與查詢自選區間產品報價中使用的值一致
> upperPrice	false	string	僅 RFQ 產品需填寫。 自選價格區間上限，須與查詢自選區間產品報價中使用的值一致
doubleWinRedeemExtra	false	Object	orderType=Redeem 時必填
> positionId	true	string	要贖回的倉位 ID，從查詢倉位資訊獲取
> estRedeemAmount	true	string	預估贖回金額，從查詢贖回預估金額獲取
> isSlippageProtected	false	bool	是否啟用贖回滑點保護。預設值：false。啟用後，當實際贖回金額與 estRedeemAmount 偏差過大時，贖回訂單將失敗

響應參數

參數	類型	說明
orderId	string	系統生成的訂單 ID
orderLinkId	string	用戶自定義訂單 ID

---

請求示例

申購（固定區間）

POST /v5/earn/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": "DoubleWin",
    "productId": "14084",
    "coin": "USDT",
    "amount": "150",
    "orderType": "Stake",
    "accountType": "FUND",
    "orderLinkId": "usdt-earn-009",
    "doubleWinStakeExtra": {
        "initialPrice": "66445.69",
        "leverage": "9"
    }
}

申購（RFQ 自選區間）

POST /v5/earn/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": "DoubleWin",
    "productId": "14092",
    "coin": "USDT",
    "amount": "200",
    "orderType": "Stake",
    "accountType": "FUND",
    "orderLinkId": "usdt-earn-010",
    "doubleWinStakeExtra": {
        "initialPrice": "66333.94",
        "lowerPrice": "63000",
        "upperPrice": "70000",
        "leverage": "245.18"
    }
}

贖回（Redeem）

POST /v5/earn/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": "DoubleWin",
    "productId": "14084",
    "orderType": "Redeem",
    "orderLinkId": "usdt-redeem-001",
    "doubleWinRedeemExtra": {
        "positionId": "2848",
        "estRedeemAmount": "148.50",
        "isSlippageProtected": true
    }
}

響應示例

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "orderId": "05184c23-8a98-456c-a2af-0ef1c45116cc",
        "orderLinkId": "usdt-earn-009"
    },
    "retExtInfo": {},
    "time": 1775107011430
}