訂單接口
下單
HTTP 請求 下單接口
- POST
/api/v2/trade/orders
限速規則：10 次/ 1s
請求參數
| 參數名 | 參數類型 | 是否必須 | 描述 |
|---|---|---|---|
| symbol | String | 是 | 幣對，詳見：/products |
| side | String | 是 | 交易方向 buy：買入 sell：賣出 |
| orderType | String | 是 | 交易類型 limit：限價 market：市價 |
| force | String | 是 | 訂單控制類型（orderType為market時無效） normal：普通限價單，一直有效至取消 postOnly：只做 maker 訂單 fok：全部成交或立即取消 ioc：立即成交並取消剩餘 |
| price | String | 否 | 限價價格（orderType為limit必填） |
| quantity | String | 是 | 委託天數 |
| clientOrderId | String | 否 | 自定義 id |
請求範例
curl -X POST "https://api-spot.weex.com/api/v2/trade/orders" \
-H "ACCESS-KEY:" \
-H "ACCESS-SIGN:" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:zh-CN" \
-H "Content-Type: application/json" \
-d '{
"symbol": "BTCUSDT_SPBL",
"side": "buy",
"orderType": "market",
"force": "normal",
"price": "0",
"quantity": "10",
"clientOrderId": "202504041121509751743736910566"
}'傳回參數
| 欄位名 | 類型 | 欄位說明 |
|---|---|---|
| orderId | Long | 訂單 id |
| clientOrderId | String | 自定義 id |
傳回範例
{
"code": "00000",
"msg": "success",
"requestTime": 1743736915184,
"data": {
"orderId": 602876318261969338,
"clientOrderId": "202504041121509751743736910566"
}
}批量下單
HTTP 請求 批量下單
- POST
/api/v2/trade/batch-orders
限速規則：10 次/ 1s
請求參數
| 參數名 | 參數類型 | 是否必須 | 描述 |
|---|---|---|---|
| symbol | String | 是 | 幣對，詳見：/products |
| orderList | List | 是 | 下單集合 |
- orderList 參數
| 參數名 | 參數類型 | 是否必須 | 描述 |
|---|---|---|---|
| side | String | 是 | 交易方向 buy：買入 sell：賣出 |
| orderType | String | 是 | 交易類型 limit：限價 market：市價 |
| force | String | 是 | 訂單控制類型（orderType為market時無效） normal：普通限價單，一直有效直至取消 postOnly：只做 maker 訂單 fok：全部成交或立即取消 ioc：立即成交並取消剩餘 |
| price | String | 否 | 限價價格（orderType為limit必填） |
| quantity | String | 是 | 委託天數 |
| clientOrderId | String | 否 | 自定義 id |
請求範例
curl -X POST "https://api-spot.weex.com/api/v2/trade/batch-orders" \
-H "ACCESS-KEY:" \
-H "ACCESS-SIGN:" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:zh-CN" \
-H "Content-Type: application/json" \
-d '{"symbol": "BTCUSDT_SPBL",
"orderList": [{
"side": "sell",
"orderType": "limit",
"force": "normal",
"price": "100000",
"quantity": "1",
"clientOrderId": "202504041144444401743738284072"
}]}'傳回參數
| 欄位名 | 類型 | 欄位說明 |
|---|---|---|
| resultList | array | array |
| >orderId | Long | 訂單 id |
| >clientOrderId | String | 自定義 id |
傳回範例
{
"code": "00000",
"msg": "success",
"requestTime": 1743738287975,
"data": {
"resultList": [{
"orderId": 602882076026339770,
"clientOrderId": "202504041144444401743738284072"
}]
}
}撤單
HTTP 請求 撤單操作
- POST
/api/v2/trade/cancel-order
限速規則：10 次/ 1s
請求參數
| 參數名 | 參數類型 | 是否必須 | 描述 |
|---|---|---|---|
| symbol | String | 是 | 幣對，詳見：/products |
| orderId | String | 是 | 訂單 id |
請求範例
curl -X POST "https://api-spot.weex.com/api/v2/trade/cancel-order" \
-H "ACCESS-KEY:" \
-H "ACCESS-SIGN:" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:zh-CN" \
-H "Content-Type: application/json" \
-d '{"symbol": "WXTUSDT_SPBL","orderId": "602882076026339770"}'傳回參數
| 欄位名 | 類型 | 欄位說明 |
|---|---|---|
| order_id | String | 訂單 ID |
| client_oid | String | 客戶端訂單ID |
| symbol | String | 交易對 |
| result | Boolean | 是否取消成功 |
| err_code | String | 錯誤碼 |
| err_msg | String | 錯誤信息 |
傳回範例
{
"code": "00000",
"msg": "success",
"requestTime": 1743740792018,
"data": {
"order_id": "602882076026339770",
"client_oid": null,
"symbol": "WXTUSDT_SPBL",
"result": true,
"err_code": null,
"err_msg": null
}
}批量撤單(單對)
HTTP 請求 批量撤單請求
- POST
/api/v2/trade/cancel-batch-orders
限速規則：10次/1s
請求參數
| 參數名 | 參數類型 | 是否必須 | 描述 |
|---|---|---|---|
| symbol | String | 是 | 幣對，詳見：/products |
| orderIds | String[] | 是 | 訂單id數組 |
請求範例
curl -X POST “https://api-spot.weex.com/api/v2/trade/cancel-batch-orders” \
-H “ACCESS-KEY:” \
-H “ACCESS-SIGN:” \
-H “ACCESS-PASSPHRASE:*” \
-H “ACCESS-TIMESTAMP:1659076670000” \
-H “locale:zh-CN” \
-H “Content-Type: application/json” \
-d ‘{“symbol”: “WXTUSDT_SPBL”,
“orderIds”: [“602926152964637114″,”602914146790408634”]
}’
傳回參數
| 欄位名 | 類型 | 欄位說明 |
|---|---|---|
| successList | Array | 成功訂單數組 |
| failureList | Array | 失敗訂單數組 |
| > orderId | String | 訂單 ID |
| > errMsg | String | 錯誤信息 |
傳回參數
{
"code": "00000",
"msg": "success",
"requestTime": 1743748830875,
"data": {
"successList": ["602926152964637114"],
"failureList": [{
"errMsg": "FAILED_ORDER_NOT_FOUND",
"orderId": "602914146790408634"
}]
}
}WEEX唯客官網：www.weex.com
你也可以在 CMC｜ Coingecko｜非小號｜X(Twitter)｜Youtube｜Facebook｜Linkedin｜微博 上關注我们，第一时间获取更多投資導航和福利活動！了解平台幣 WXT 最新資訊請訪問 WXT專區
在線諮詢：
WEEX唯客中文交流群：https://t.me/weex_group
WEEX唯客英文交流群：https://t.me/Weex_Global
