取消訂單 - 4casters API

支援四種取消方式。它們都使用相同的回應結構：{ requestID, data: [ ...CancelResponsePayload ] }。

取消回應酬載

每次成功取消都會回傳一條或多條如下形態的記錄。注意請求與回應的欄位大小寫不同：請求為 orderId/gameId（d 小寫），回應為 orderID/gameID（ID 大寫）。

{
  "success": true,
  "orderID": "67f45377c18c6697c172afa4",
  "odds": -110,
  "filled": 0,
  "offered": 100,
  "remaining": 100,
  "side": "5c12bc1ce0daba000f47ba8b",
  "number": -3.5,
  "gameID": "688c0516fbc14da0c202d426",
  "userReference": "client-ref-001",
  "description": "Dallas Mavericks +3.5"
}

boolean

訂單已取消時為 true。

string

被取消訂單的 ID。

number

取消到達前已經成交的數量。

number

取消後始終為 0 — 掛單側已歸零。

number

取消時尚未成交的數量。

number

被取消訂單的美式賠率，從 maker 視角給出。

string

參賽者 ID（moneyline/spread）或 over/under（大小球）。

number

讓分或大小球盤口數值；moneyline 為 null。

string

被取消訂單所屬的賽事。

string

下單時設定的 userReference（如有）。

string

投注的人類可讀描述（例如 "Dallas Mavericks +3.5"）。

按 ID 取消

按訂單 ID 取消單筆訂單。

請求

[
  "cancelById",
  {
    "requestID": "YOUR_REQUEST_ID",
    "orderId": "ORDER_ID_TO_CANCEL"
  }
]

回應

{
  "requestID": "YOUR_REQUEST_ID",
  "data": [
    {
      "success": true,
      "orderID": "67f45377c18c6697c172afa4",
      "odds": -110,
      "filled": 0,
      "offered": 0,
      "remaining": 100,
      "side": "5c12bc1ce0daba000f47ba8b",
      "number": -3.5,
      "gameID": "688c0516fbc14da0c202d426",
      "userReference": "client-ref-001",
      "description": "Dallas Mavericks +3.5"
    }
  ]
}

批次取消

按 ID 取消一組指定訂單。

請求

[
  "cancelMultiple",
  {
    "requestID": "YOUR_REQUEST_ID",
    "orderIDs": [
      "ORDER_ID_1",
      "ORDER_ID_2",
      "ORDER_ID_3"
    ]
  }
]

回應

data 中每個訂單 ID 對應一條記錄；請檢查每條的 success 標誌。

{
  "requestID": "YOUR_REQUEST_ID",
  "data": [
    {
      "success": true,
      "orderID": "ORDER_ID_1",
      "odds": -110,
      "filled": 0,
      "offered": 0,
      "remaining": 100,
      "side": "5c12bc1ce0daba000f47ba8b",
      "number": -3.5,
      "gameID": "688c0516fbc14da0c202d426",
      "userReference": "",
      "description": "Dallas Mavericks +3.5"
    },
    {
      "success": false,
      "orderID": "ORDER_ID_2",
      "description": "order already cancelled"
    }
  ]
}

按賽事全部取消

取消你在單場賽事上的全部未成交訂單。可選擇傳入 type、side 和/或 market，將取消範圍限定到特定盤口。

請求

[
  "cancelAllByGame",
  {
    "requestID": "YOUR_REQUEST_ID",
    "gameId": "GAME_ID_TO_CANCEL",
    "type": "spread",
    "side": "5c12bc1ce0daba000f47ba8b",
    "market": "main"
  }
]

string

必填

要取消訂單的賽事。

string

可選 — 過濾到單一盤口型別：moneyline、spread、total 或 moneyline1x2。

string

可選 — 參賽者 ID（moneyline/spread）或 over/under（大小球）。

string

可選 — 盤口識別符號（例如 main）。

回應

{
  "requestID": "YOUR_REQUEST_ID",
  "data": [
    {
      "success": true,
      "orderID": "67f45377c18c6697c172afa4",
      "odds": -110,
      "filled": 0,
      "offered": 0,
      "remaining": 100,
      "side": "5c12bc1ce0daba000f47ba8b",
      "number": -3.5,
      "gameID": "688c0516fbc14da0c202d426",
      "userReference": "",
      "description": "Dallas Mavericks +3.5"
    }
  ]
}

全部取消

取消帳戶上的全部未成交訂單。

請求

[
  "cancelAll",
  {
    "requestID": "YOUR_REQUEST_ID"
  }
]

回應

{
  "requestID": "YOUR_REQUEST_ID",
  "data": [
    {
      "success": true,
      "orderID": "67f45377c18c6697c172afa4",
      "odds": -110,
      "filled": 0,
      "offered": 0,
      "remaining": 100,
      "side": "5c12bc1ce0daba000f47ba8b",
      "number": -3.5,
      "gameID": "688c0516fbc14da0c202d426",
      "userReference": "",
      "description": "Dallas Mavericks +3.5"
    }
  ]
}

錯誤

當取消無法處理時，伺服器回傳標準錯誤結構（無 data 欄位）：

{
  "requestID": "YOUR_REQUEST_ID",
  "error": "order not found"
}

常見 error 值：

錯誤	何時出現
`invalid order ID format`	`cancelById` 的 `orderId` 不是有效的 ObjectID。
`order not found`	該訂單 ID 不存在。
`unauthorized: order does not belong to user`	你正在嘗試取消他人的訂單。
`order already cancelled`	該訂單已被取消。
`order is expired`	訂單在取消到達前已過期。
`order already graded`	該訂單已經結算。
`game not found`	所引用的賽事不在快取中。
`Failed to process cancelMultiple`	處理 `cancelMultiple` 批次時發生意外錯誤。
`Failed to process cancelAll`	處理 `cancelAll` 時發生意外錯誤。
`Failed to process cancelAllByGame`	處理 `cancelAllByGame` 時發生意外錯誤。

對於批次取消（cancelMultiple、cancelAllByGame、cancelAll），單筆失敗會出現在 data 中，帶有 success: false 以及解釋原因的 description — 只有結構級的 error 才表示整個請求失敗。

​取消回應酬載

​按 ID 取消

​請求

​回應

​批次取消

​請求

​回應

​按賽事全部取消

​請求

​回應

​全部取消

​請求

​回應

​錯誤

取消回應酬載

按 ID 取消

請求

回應

批次取消

請求

回應

按賽事全部取消

請求

回應

全部取消

請求

回應

錯誤