Skip to main content
POST
Place orders
提交一筆或多筆訂單。該介面接受批次請求——每筆訂單的結果在 data.createdSessions 中回傳,並與輸入的 orders 陣列按位置一一對應。每條結果要麼是成功的 { matched, unmatched },要麼是失敗的 { error, errorType }。

請求

POST /session/v3/place

訂單欄位

訂單型別

limit

預設訂單型別。作為 taker(收取 taker 佣金)按你的價格或更優價格吃掉任何可匹配流動性,未成交部分作為 maker 留在訂單簿上。limit 訂單最終可以是全部成交、全部掛單,或部分成交、剩餘掛單。

post

建立一筆掛單。如果下單時該訂單會與已有流動性成交,伺服器會拒絕它(rejected_order_type_rules,例如 "post order cannot have matches")。

postArb

行為類似 post,但即使訂單會成交也可以掛單,前提是你的美式賠率與將被成交的掛單賠率相差不超過 1%。若價差超過 1%,下單會被拒絕。 示例:
  • 最優報價 +100,你掛 +100 — post 會被拒絕(會成交);postArb 允許。
  • 最優報價 +200 — 以 +190 提交的 postArb 會被拒絕(距離 +200 過遠)。約 +198 處於相對 +200 的 1% 區間邊緣。
  • 最優訂單 −200 — 負向一側區間大約延伸到 −202(同一條 1% 規則)。
  • 訂單簿上有 +100 時,對側的 1% 容差參考限價為 −101。
postArb 可避免普通成交中的 taker 手續費 — 走該流程時,不會像作為 taker 主動吃掉掛單流動性那樣被收取 taker 手續費。 以 postArb 下的訂單,會在其使用者推送和行情推送更新中帶有 isPostArb: true;其他訂單型別會省略該欄位。下單回應本身不包含該標誌。

fillAndKill

立即作為 taker 按你的價格或更優價格吃掉當前可成交數量,並取消剩餘部分。fillAndKill 永遠不會留在訂單簿上。 部分成交也是成功結果:如果你傳送 bet: 1000 而可匹配流動性只有 400,則成交400,則成交 400,剩餘 $600 被取消——回應為成功,而非錯誤。僅當完全沒有可匹配流動性時,訂單才會被拒絕(rejected_order_type_rules,"fill and kill has no matches")。參見下方示例中的 Fill And Kill 場景。

fillOrKill

全成或全撤。你的整筆 bet 必須立即按你的價格或更優價格成交,否則整筆訂單被拒絕——包括途中已發生的成交,都會復原。fillOrKill 永遠不會留在訂單簿上,也不會留下部分倉位。 適用於部分倉位還不如沒有倉位的情形,例如該訂單是一筆必須整筆執行的對沖腿。 拒絕時 errorType: rejected_order_type_rules,並帶有以下兩條訊息之一,用於區分「完全沒有流動性」和「流動性不足」:
  • "fill or kill has no matches" — 你的價格上沒有任何可匹配流動性。
  • "fill or kill matched but not fully" — 有部分流動性成交,但未達到你的全部數量。這些成交已被復原。
剩餘量 **10及以下∗∗視為已完成:一筆10 及以下** 視為已完成:一筆 1,000 的 fillOrKill 若成交 992即算成功,因為未能成交的992 即算成功,因為未能成交的 8 低於訂單簿上可掛單的最小數量。剩餘量大於 $10 則會拒絕該訂單。

回應

array
每筆訂單的結果,與輸入的 orders 陣列按位置對應。每條要麼是成功下單,要麼是錯誤。

示例

場景 1 — 訂單全部成交、無剩餘掛單

三筆訂單均立即與可用流動性成交。

場景 2 — 限價單有剩餘掛單

一筆數量為 300 的限價單部分成交,剩餘部分掛在訂單簿上。

場景 3 — Fill and Kill,全部成交

場景 4 — Fill and Kill,無成交

沒有成交的 fillAndKill 會回傳單筆訂單錯誤。

場景 5 — Fill or Kill,流動性不足

fillOrKill 是 fillAndKill 的全成或全撤對應物。一筆 1,000的‘fillAndKill‘面對1,000 的 `fillAndKill` 面對 400 流動性會成交 400並取消剩餘;而‘fillOrKill‘會拒絕整筆訂單並復原那400 並取消剩餘;而 `fillOrKill` 會拒絕整筆訂單並復原那 400——你不會留下部分倉位。
若完全沒有可匹配流動性,同一筆訂單會改為以 "fill or kill has no matches" 被拒絕。

場景 6 — 訂單簿會成交時的 postArb 與 post

post 會拒絕將與掛單流動性成交的訂單(例如最優報價 +100,你嘗試掛 +100)。當你的賠率與將被成交訂單相差不超過 1% 時,postArb 允許這種情況——因此同樣掛 +100 可以作為 postArb 成功,並避免普通成交中需支付的 taker 手續費。若你的價格距離掛單報價過遠(例如最優報價 +200 但你傳送 +190),postArb 會被拒絕。

場景 7 — moneyline1x2(足球三項盤)

moneyline1x2 是足球三項盤——主勝 / 客勝 / 平局——以 market 所指定結果的是/否投注形式下單。以下為平局 yes,賠率 +250。
若要投注主隊不勝,傳送 side: "no",並將 market 設為主隊參賽者 id。

滾球延遲

在標記為滾球的賽事上下單時,遵循以下規則:
  1. 若訂單不與任何已有流動性成交,則立即掛單。
  2. 若訂單會與已有流動性成交,則在執行前會有一段延遲。
  3. 不同聯賽的滾球延遲不同:
    • NFL、UFCMMA、NCAAF — 3 秒。
    • NCAAB、NBA — 5 秒。
    • ATP、WTA — 8 秒。
    • 預設 — 10 秒。
  4. 延遲結束後,訂單嘗試執行:
    • 若賠率變得更優,則立即成交。
    • 若賠率變差,則不成交。

單筆訂單錯誤

多筆下單、部分出錯的示例:

授權

Authorization
string
header
必填

Pass your auth token in the Authorization header. The Bearer prefix is optional; the server also accepts a signed auth cookie or a token field in the request body.

主體

application/json
orders
object[]
必填

回應

Per-order results (positional with input).

data
object