跳至主要内容

下單

信息
  • 訂單為非同步處理。成功響應表示訂單已被接受,而非已完成結算。請使用查詢訂單列表追蹤訂單狀態。
  • orderLinkId 提供冪等性保障——提交相同 orderLinkId 將返回相同 orderId,不會建立重複訂單。
  • Mint(鑄造):將 USDT 從活期理財帳戶轉入,鑄造 byUSDT。
  • Redeem(贖回):銷毀 byUSDT,將 USDT 返還至統一交易帳戶(UTA)。

HTTP 請求

POST/v5/earn/token/place-order

請求參數

參數必填類型說明
cointruestring代幣幣種。目前僅支援 BYUSDT
orderLinkIdtruestring用戶自定義訂單 ID(最多 36 個字元),用於冪等性控制及訂單查詢
orderTypetruestring訂單類型:Mint(USDT → byUSDT)、Redeem(byUSDT → USDT)
amounttruestring訂單金額(十進位字串)。Mint 時為 USDT 數量;Redeem 時為 byUSDT 數量
accountTypetruestring帳戶類型。Mint 時必須為 FlexibleSavingRedeem 時必須為 UNIFIED

響應參數

參數類型說明
orderIdstring系統生成的訂單 ID(UUID)
orderLinkIdstring用戶自定義訂單 ID

請求示例

POST /v5/earn/token/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

{
"coin": "BYUSDT",
"orderLinkId": "my-order-001",
"orderType": "Mint",
"amount": "100.00",
"accountType": "FlexibleSaving"
}

響應示例

{
"retCode": 0,
"retMsg": "success",
"result": {
"orderId": "550e8400-e29b-41d4-a716-446655440000",
"orderLinkId": "my-order-001"
},
"retExtInfo": {},
"time": 1741651200000
}