WebSocket API v1 交易 - addOrder 和 cancelOrder

上次更新: 2025年4月1日
  • 下單 - addOrder

  • 取消訂單 - cancelOrder

透過 WebSocket API v1 進行交易(下單和取消訂單)由 addOrdercancelOrder 端點提供。與透過 REST API 進行交易類似,addOrder 端點用於下新訂單,而 cancelOrder 端點用於取消現有(未結)訂單。

一旦與 WebSocket API 的連線建立,便可透過以下步驟下單和取消訂單:

  1. 1

    透過 REST API GetWebSocketsToken 端點 取得驗證代幣(一旦取得有效的代幣,同一個代幣可用於多個 addOrder/cancelOrder 請求),

  2. 2

    發送適當的 addOrder/cancelOrder 請求,

  3. 3

    接收回應,指示請求是否成功。

下單 - addOrder

我們的 WebSocket API 文件提供了 addOrder 端點的完整規格,包括必須使用的 JSON 格式,以及每個必填和選填欄位的說明。

例如,以下 JSON 訊息將下一個新訂單,以 150 歐元的限價購買 0.25 ETH/EUR:

{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}

假設上述訂單成功下達(帳戶餘額有足夠資金等),將收到以下 JSON 訊息作為回應:

{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}

取消訂單 - cancelOrder

我們的 WebSocket API 文件提供了 cancelOrder 端點的完整規格,包括必須使用的 JSON 格式,以及每個必填和選填欄位的說明。

與 REST API 不同,WebSocket API cancelOrder 端點可用於同時取消多個訂單,方法是在 txid 陣列中指定每個訂單 ID(或用戶參考)。

例如,以下 JSON 訊息將取消任何具有匹配訂單 ID 的未結訂單:

{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}

假設訂單成功取消,將收到以下 JSON 訊息作為回應:

{
"event": "cancelOrderStatus",
"status": "ok"
}

需要更多幫助?