> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4casters.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新日誌

> 4casters API 中對用戶端可見的重要變更。

本更新日誌記錄對整合方可觀察的 4casters 公開 API 變更。內部重構、不改變行為的效能修復，以及基礎設施變更有意省略。

約定：

* 最新條目在前。日期為 ISO `YYYY-MM-DD`。
* 每條條目標註受影響的 API 介面。
* 變更歸類在「新增」「變更」「修復」「棄用」或「移除」下（不適用的小節會省略）。
* 破壞性變更標註為 `Breaking`。

***

<Update label="2026-08-13" tags={["REST API", "訂單 API"]}>
  ### 新增

  * **`fillOrKill` 訂單型別。** 全成或全撤的吃單：必須立即撮合全部 `bet`，否則整筆訂單被拒絕並復原任何部分成交，因此你不會停留在部分成交狀態。REST 和 WebSocket 下單端點均支援。見 [訂單型別](/zh-Hant/pages/rest/orders/place-order#order-types)。

  ### 修復

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

<Update label="2026-07-30" tags={["REST API"]}>
  ### 新增

  * **`GET /exchange/getMatchedVolume`。** 新端點，回傳一段 ET 日曆日範圍（首尾兩天均含）內的全站已撮合成交量。每筆已撮合投注計入雙方本金（風險額 + 可贏額，佣金前）；結束於今天的範圍包含當天的即時彙總。見 [獲取已撮合成交量](/zh-Hant/pages/rest/markets/get-matched-volume)。
</Update>

<Update label="2026-07-15" tags={["推送 API", "使用者推送"]}>
  ### 修復

  * **`GET /v2/user/messages` 回放現在會回傳訊息。** v2 使用者推送回放端點此前始終回傳空列表，因此斷線後的缺口恢復會靜默無效。回放訊息的形態與 WebSocket 送達的完全一致。見 [回放錯過的訊息](/zh-Hant/pages/streaming/user-feed#replaying-missed-messages)。
</Update>

<Update label="2026-04-28" tags={["推送 API", "行情推送"]}>
  ### 新增

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

  ### 變更

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.