下單
信息
- 訂單為非同步處理。成功響應表示訂單已被接受,而非已完成結算。請使用查詢訂單列表追蹤訂單狀態。
orderLinkId提供冪等性保障——提交相同orderLinkId將返回相同orderId,不會建立重複訂單。- Mint(鑄造):將 USDT 從活期理財帳戶轉入,鑄造 byUSDT。
- Redeem(贖回):銷毀 byUSDT,將 USDT 返還至統一交易帳戶(UTA)。
HTTP 請求
POST/v5/earn/token/place-order請求參數
| 參數 | 必填 | 類型 | 說明 |
|---|---|---|---|
| coin | true | string | 代幣幣種。目前僅支援 BYUSDT |
| orderLinkId | true | string | 用戶自定義訂單 ID(最多 36 個字元),用於冪等性控制及訂單查詢 |
| orderType | true | string | 訂單類型:Mint(USDT → byUSDT)、Redeem(byUSDT → USDT) |
| amount | true | string | 訂單金額(十進位字串)。Mint 時為 USDT 數量;Redeem 時為 byUSDT 數量 |
| accountType | true | string | 帳戶類型。Mint 時必須為 FlexibleSaving;Redeem 時必須為 UNIFIED |
響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
| orderId | string | 系統生成的訂單 ID(UUID) |
| orderLinkId | string | 用戶自定義訂單 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
}