Skip to main content
本更新日誌記錄對整合方可觀察的 4casters 公開 API 變更。內部重構、不改變行為的效能修復,以及基礎設施變更有意省略。 約定:
  • 最新條目在前。日期為 ISO YYYY-MM-DD。
  • 每條條目標註受影響的 API 介面。
  • 變更歸類在「新增」「變更」「修復」「棄用」或「移除」下(不適用的小節會省略)。
  • 破壞性變更標註為 Breaking。

REST API訂單 API

新增

  • fillOrKill 訂單型別。 全成或全撤的吃單:必須立即撮合全部 bet,否則整筆訂單被拒絕並復原任何部分成交,因此你不會停留在部分成交狀態。REST 和 WebSocket 下單端點均支援。見 訂單型別。

修復

  • 更正了 fillAndKill 文件。 原先描述為「按你的價格立即成交,否則拒絕」,讀起來像全成或全撤。fillAndKill 實際會成交當前可成交數量並取消剩餘部分 — 部分成交即為成功結果,僅在完全沒有可撮合流動性時才會被拒絕。行為未變;只是文件有誤。若需要真正的全成或全撤執行,請使用新的 fillOrKill。
REST API

新增

  • GET /exchange/getMatchedVolume。 新端點,回傳一段 ET 日曆日範圍(首尾兩天均含)內的全站已撮合成交量。每筆已撮合投注計入雙方本金(風險額 + 可贏額,佣金前);結束於今天的範圍包含當天的即時彙總。見 獲取已撮合成交量。
推送 API使用者推送

修復

  • GET /v2/user/messages 回放現在會回傳訊息。 v2 使用者推送回放端點此前始終回傳空列表,因此斷線後的缺口恢復會靜默無效。回放訊息的形態與 WebSocket 送達的完全一致。見 回放錯過的訊息。
推送 API行情推送

新增

  • 行情推送可按 gameID、league 或 sport 訂閱。 連線到 wss://streaming-api.4casters.io/price-stream 的用戶端現在可以傳送 JSON 的 subscribe、unsubscribe 和 subscribeAll 命令,將推送收窄到特定賽事、聯賽或運動項目。完整命令形態與路由語義見 訂閱。
  • parentGameID 扇出。 訂閱父級 gameID 的用戶端也會收到 parentGameID 匹配的子賽事更新(例如 F5-MLB 衍生盤會到達父賽事的訂閱者)。

變更

  • 向後相容。 從不傳送 subscribe 命令的用戶端保持廣播全部模式,並像以前一樣接收每條更新 — 無需更改整合。