桌檯與局結果

桌檯清單

GET /tables 列出你可以選的桌（平台桌、你自己建的桌，以及其他商戶提供給你的桌），以及你是否已啟用：

json

{
  "ok": true,
  "data": {
    "tables": [
      {
        "tableId": "S01",
        "game": "baccarat",
        "variants": ["classic", "nocomm"],
        "name": { "CHT": "模擬百家樂 1", "CHS": "模拟百家乐 1", "ENG": "Sim Baccarat 1" },
        "status": "open",
        "betSeconds": 20,
        "enabled": true
      }
    ]
  }
}

欄位	說明
`tableId`	桌號，用在 launch 的 `table`、注單的 `tableId`
`game`	`baccarat` 百家樂、`dragontiger` 龍虎、`holdem` 德州撲克、`niuniu` 牛牛
`variants`	這張桌提供的玩法；百家樂為 `classic`（傳統）與 `nocomm`（免佣），牛牛為 `standard`
`name`	各語系桌名，鍵為語系代碼
`status`	`open` 開放、`maintenance` 維護中
`betSeconds`	預設下注秒數
`enabled`	你是否已啟用；玩家只看得到你已啟用的桌
`provider`	只有其他商戶提供給你的桌才有：`{ "name": 提供者名稱 }`

沙箱租戶已啟用所有模擬器桌：S01、S02（百家樂）、S03（龍虎）與 N01（牛牛）。

啟用與停用

可以在 Console 桌檯 → 桌檯管理 操作，也可以用 API：

text

POST /api/tenant/v1/tables/enable     {"tableId": "S01"}
POST /api/tenant/v1/tables/disable    {"tableId": "S01"}

json

{ "ok": true, "data": { "tableId": "S01", "enabled": true, "used": 2, "quota": 2 } }

免費方案最多啟用配額內的桌數（預設 2 桌，平台可對個別租戶調整），超過回 409 QUOTA_EXCEEDED。
付費方案沒有配額（quota 為 null），啟用的當天起每桌每月 100 USD，依日按比例從預付額度扣，見計費說明。
帳戶停權時回 409 ACCOUNT_LOCKED；桌號不存在回 404 NOT_FOUND。
停用後玩家立刻看不到、也進不去這張桌；停用當天仍計費一天。
已啟用的桌再啟用一次不會出錯。

其他商戶提供的桌

商戶可以把自己建的桌（自己的攝影棚、荷官與讀牌器）提供給其他商戶使用。平台開放跨商戶提供、提供者的申請經平台核准，而且把你列為對象（或提供給所有商戶）時，這張桌會出現在你的 GET /tables，多一個 provider：

json

{
  "tableId": "STUDIO-B1",
  "game": "baccarat",
  "variants": ["classic", "nocomm"],
  "name": { "CHT": "旗艦攝影棚 B1", "ENG": "Studio B1" },
  "status": "open",
  "betSeconds": 20,
  "enabled": false,
  "provider": { "name": "旗艦娛樂" }
}

啟用、停用和平台桌一樣（POST /tables/enable、/tables/disable，或 Console 桌檯管理 → 其他商戶提供的桌），也和平台桌一樣算進你的桌數與桌費。
錢不跨商戶：你的玩家照你的限紅下注、由你結算，注單照常出現在你的 GET /bets；提供者只提供桌、影像與開牌結果。你可以在 Console 另外設定這張桌的限紅上限（比你的限紅更低）。
只有真人讀牌器（RoadMapServer 讀牌）與德州掃描器的桌、經平台審核後才能提供；平台每小時監控每張提供桌對各使用商戶的輸贏，異常時可能停止提供。
德州玩家對玩家桌例外：你的玩家和其他商戶的玩家同桌對打，錢在玩家之間移轉（平台的玩家對玩家桌也一樣）。只有和桌同幣別、同一個資金池（正式商戶和正式商戶；沙箱與平台展示帳戶和試玩的桌）才能啟用。平台逐手記下每個商戶的淨額（玩家輸贏＋歸你的抽水），每天從你的預付額度扣款或入帳，見計費說明。
提供者停止提供、把你移出對象，或平台停止這張桌時，這張桌在本局結束後從你的大廳下架：新的下注被拒，本局已下的注照常結算，GET /tables 不再列出，已啟用的自動停用。平台暫停跨商戶提供時一樣立即下架，重新開放後自動恢復。
視訊由提供者推流，觀看流量算你的（和平台桌一樣依觀看者的商戶計算）。
提供者可以收使用費（每日固定費或有效投注的百分比），由平台每天從你的預付額度代收，見計費說明。

局的生命週期

開放下注：倒數由資料源提供（沒有時使用桌的 betSeconds）。
停止下注：倒數結束、資料源送出停止下注，或開始發牌時立即封盤。
開牌與結算：收到結果後驗證牌面與補牌規則，然後結算所有注單並自動派彩；注單出現在 GET /bets，局結果出現在 GET /rounds/{roundId}。
作廢：倒牌、荷官失誤、設備故障等情況下，資料源會作廢該局，所有注單全額退回本金（牛牛連同預扣；注單 status: void）。
異常局：已停止下注但 10 分鐘內沒有收到結果的局，會自動作廢並退款。
修正：結算後 30 分鐘內收到的修正，若新結果完整且通過規則驗證，會自動重算（注單以新的 rev 出現）；超出護欄時維持原結果、不動金額，並把該局標為爭議局（disputed）。

資料源中斷時，該桌會立即停止收注，恢復後自動繼續；平台維護桌檯時，GET /tables 的 status 為 maintenance。

查詢局結果

text

GET /api/tenant/v1/rounds/01K5Y0B8Z6R2M4N7P9Q3S5T8VW

json

{
  "ok": true,
  "data": {
    "roundId": "01K5Y0B8Z6R2M4N7P9Q3S5T8VW",
    "tableId": "S01",
    "shoe": "260924-03",
    "round": 12,
    "status": "settled",
    "code": "1",
    "cardInfo": "122334424000",
    "result": {
      "cards": { "P1": "2C", "B1": "4H", "P2": "3D", "B2": "2S", "P3": "10S" },
      "player": 5,
      "banker": 6,
      "winner": "B",
      "playerPair": false,
      "bankerPair": false
    },
    "complete": true,
    "rev": 1,
    "openedAt": "2026-09-24T03:00:30.012Z",
    "settledAt": "2026-09-24T03:01:20.480Z"
  }
}

roundId 是 26 字元的大寫 ULID，可以從注單的 roundId 取得。格式不符時回 404 NOT_FOUND；局尚未結算時回 404 ROUND_NOT_FOUND。
status：settled 已結算、void 作廢、disputed 爭議局。
rev：結果版次，第一次結果為 1，每次修正與作廢各加 1。
complete：true 表示有完整牌面；false 表示資料源只提供了輸贏與點數（沒有牌面時 cardInfo 中的牌以 00 表示；牛牛則是各家輸贏，可能附牌型）。
牛牛每局一副新牌、沒有靴：shoe 是場次（預設每 60 局換一場），round 是本場次第幾局。範例見牛牛的局結果。

結果碼

code 是一個十六進位字元，由位元組成：

位元	百家樂	龍虎
bit 0–1（值 1–3）	1 莊贏、2 閒贏、3 和	1 龍贏、2 虎贏、3 和
bit 2（值 4）	莊對	同花和
bit 3（值 8）	閒對	—

所有可能的值：

`code`	百家樂	`code`	百家樂
`1`	莊	`9`	莊、閒對
`2`	閒	`A`	閒、閒對
`3`	和	`B`	和、閒對
`5`	莊、莊對	`D`	莊、莊對、閒對
`6`	閒、莊對	`E`	閒、莊對、閒對
`7`	和、莊對	`F`	和、莊對、閒對

龍虎：1 龍、2 虎、3 和、7 同花和。作廢且沒有結果的局，注單的 result.code 為空字串。

牛牛的結果碼

牛牛的 code 是 5 個字元：[勝負][莊][閒一][閒二][閒三]。

勝負：贏莊的閒家位元相加（閒一 1、閒二 2、閒三 4），十六進位 0–7；0 為莊通殺、7 為莊通賠。
各家牌型：0 無牛、1–9 牛1～牛9、A 牛牛、B 五花牛、C 炸彈、D 五小牛（B–D 只在開啟特殊牌型的桌出現）；- 表示不知道這一家的牌型（資料源的結果不完整）。

範例	解讀
`5893A`	5 = 1 + 4：閒一、閒三贏。莊牛8、閒一牛9、閒二牛3、閒三牛牛
`0A123`	莊牛牛，閒一牛1、閒二牛2、閒三牛3 都輸（莊通殺）

注單的 result.hands、result.winners 就是解好的各家牌型與輸贏，見牛牛的注單。

牌面字串

cardInfo 每張牌 2 個字元：花色（1 梅花 ♣、2 方塊 ♦、3 紅心 ♥、4 黑桃 ♠）＋點數（1 為 A、2–9、0 為 10、J、Q、K）；00 表示沒有這張牌。

百家樂：12 個字元，依序為閒 1、閒 2、莊 1、莊 2、閒補牌、莊補牌。
龍虎：4 個字元，依序為龍、虎。
牛牛：寫法不同，見牛牛的牌面字串。

範例	解讀
`122334424000`	閒 2♣ 3♦，莊 4♥ 2♠，閒補 10♠，莊不補 → 閒 5 點、莊 6 點，莊贏
`3K49`	龍 K♥、虎 9♠ → 龍贏

牛牛的牌面字串

牛牛的 cardInfo 是 頭牌|莊|閒一|閒二|閒三 五段，以 | 分隔；每段依序是那一家的第 1～5 張，牌面寫法與結構化結果相同（AS、10H、QD），以空白分隔。沒有的牌省略（資料源的結果不完整時，可能整段都是空的）。

範例	解讀
`7H\|KS QD 10C 3S 5H\|4C 6D JS 9C KH\|2D 8S QC AH 2C\|7D 3H KD 5C 5D`	頭牌 7♥；莊 K♠ Q♦ 10♣ 3♠ 5♥＝牛8；閒一 4♣ 6♦ J♠ 9♣ K♥＝牛9；閒二 2♦ 8♠ Q♣ A♥ 2♣＝牛3；閒三 7♦ 3♥ K♦ 5♣ 5♦＝牛牛

結構化結果

GET /rounds/{roundId} 的 result 與資料源介面 GFI 的結果格式相同，牌面寫法為 <點數><花色>，例如 AS、10H、QD（花色 S 黑桃、H 紅心、D 方塊、C 梅花）。

百家樂：cards（位置 P1 B1 P2 B2 P3 B3，未發的牌省略）、player、banker（點數 0–9）、winner（P、B、T）、playerPair、bankerPair。
龍虎：cards（D、T）、winner（D 龍、T 虎、TIE 和）。龍虎點數 A=1 … K=13（A 最小），不比花色；點數相同且花色相同為同花和。
牛牛：cards（牌位 F 頭牌、B-1～B-5 莊、P1-1～P1-5 閒一、P2-1～P2-5 閒二、P3-1～P3-5 閒三，完整結果 21 張）、hands（各家牌型代碼 0–13）、winners（P1、P2、P3 各自對莊：P 閒贏、B 莊贏）。範例見牛牛的局結果。

投注區與賠率

以下為平台預設賠率（「賠率」指淨贏倍數，退回金額 = 本金 × (1 + 賠率)）：

投注區	代碼	傳統 `classic`	免佣 `nocomm`
莊	`B`	0.95	1（莊 6 點贏時 0.5）
閒	`P`	1	1
和	`T`	8	8
莊對	`BP`	11	11
閒對	`PP`	11	11
超級六	`S6`	—	12（莊 6 點贏）

和局時，押莊、押閒的本金退回。
派彩計算到小數第 4 位，更小的位數捨去。

龍虎（dragontiger）：

投注區	代碼	賠率
龍	`D`	1（和局時退回一半本金）
虎	`TG`	1（和局時退回一半本金）
和	`T`	8
同花和	`ST`	50
龍大、龍小、龍單、龍雙	`DB`、`DS`、`DO`、`DE`	1
虎大、虎小、虎單、虎雙	`TB`、`TS`、`TO`、`TE`	1

大小單雙只在您於 Console「桌檯設定」開啟的龍虎桌提供（預設關閉）；沒開的桌下注會被拒絕。
大小單雙只看該方那一張牌（A=1 … K=13）：大 8–K、小 A–6；單 A、3、5、9、J、K，雙 2、4、6、8、10、Q；開出 7 時大小單雙都輸。龍虎和局不影響大小單雙。
限紅：大小單雙每一區套用主注（龍虎）的最小與最大值。
結果沒有牌面（complete: false）時，大小單雙的注全額退回。

德州撲克（holdem）：

桌	投注區	代碼	說明
玩家對荷官 `casino`（Casino Hold'em）	底注	`ANTE`	依桌的賠率表派彩（預設：皇家同花順 100、同花順 20、四條 10、葫蘆 3、同花 2、其他 1）；荷官不合格（沒有一對 4 以上）時只派底注
	跟注	`CALL`	看完兩張底牌與翻牌後跟注，金額 2 倍底注，1 賠 1；荷官不合格時退回；棄牌就沒有這一區
	AA 邊注	`AAB`	玩家兩張＋翻牌三張一對 A 以上得獎（預設：一對 A、兩對、三條、順子 7，同花 20，葫蘆 30，四條 40，同花順 50，皇家同花順 100）
玩家對荷官 `thbp`（Texas Hold'em Bonus Poker）	底注	`ANTE`	玩家贏、而且最終牌型是順子以上（大西洋城賠率的桌：同花以上）時 1 賠 1，否則退回；荷官不用合格
	翻牌注	`FLOP`	看完兩張底牌後下（2 倍底注），玩家贏 1 賠 1；棄牌就沒有這一區
	轉牌注	`TURN`	翻牌後可以下（1 倍底注）或過牌，玩家贏 1 賠 1
	河牌注	`RIVER`	轉牌後可以下（1 倍底注）或過牌，玩家贏 1 賠 1
	紅利注	`BONUS`	只看玩家起手兩張（預設：AA 且荷官起手也是 AA 1000、AA 30、AK 同花 25、AQ／AJ 同花 20、AK 15、KK／QQ／JJ 10、AQ／AJ 5、22–1010 對子 3），棄牌也照賠
玩家對玩家 `nlhe`（無限注）	底池	`POT`	這手投入底池的合計；`return` 為沒被跟注而退回的部分；贏得的底池已扣抽水（注單的 `rake`）

Texas Hold'em Bonus Poker：荷官贏時所有注都輸，平手時所有注都退回。
開桌的商戶可以調整賠率表與座位數等設定；限紅用各商戶自己的德州限紅方案（底注與邊注：AA 邊注或紅利注）。
作廢：玩家對荷官桌全額退回；玩家對玩家桌退回這手所有投入（含盲注）。

牛牛（niuniu）的投注區、倍數與預扣見下一節牛牛。

牛牛

荷官的莊對閒一、閒二、閒三三家，每家 5 張牌。玩家押的是「某一家閒贏莊」，每家分平倍、翻倍兩格，共六格；同一局可以押多家、多格。

牌型與比牌

點數：A＝1，2–9 照牌面，10、J、Q、K＝10。
五張裡任三張合計是 10 的倍數＝有牛，另外兩張合計的個位數就是「牛幾」（個位數 0＝牛牛）；找不到這樣的三張＝無牛。
大小：牛牛 > 牛9 > … > 牛1 > 無牛。牌型相同時比五張裡最大的一張（K > Q > J > 10 > … > A），點數也相同再比花色（♠ > ♥ > ♣ > ♦）。一副牌不會有兩張一樣的牌，所以沒有和局。
特殊牌型：五花牛（五張都是 J、Q、K）、炸彈（四張同點數）、五小牛（五張都小於 5，合計 ≤ 10）。預設關閉，關閉時照一般的牛幾計算；開啟特殊牌型的桌，大小為五小牛 > 炸彈 > 五花牛 > 牛牛。

投注區與賠率

投注區	代碼	閒贏莊	閒輸莊
閒一、閒二、閒三平倍	`P1E`、`P2E`、`P3E`	1 賠 0.95（贏的部分抽 5%）	輸本金
閒一、閒二、閒三翻倍	`P1D`、`P2D`、`P3D`	贏本金 × 閒家牌型的倍數 × 0.95	輸本金 × 莊家牌型的倍數

翻倍的倍數看贏的那一手的牌型：

牌型	倍數
無牛～牛6	×1
牛7～牛9	×2
牛牛	×3
五花牛、炸彈、五小牛（開啟特殊牌型的桌）	×4、×4、×5

以上是預設規則（平台的模擬桌 N01 採用這套規則）；個別桌可以調整抽水、倍數表與特殊牌型。
派彩計算到小數第 4 位，更小的位數捨去。
結果不完整（complete: false，資料源只提供各家輸贏）時，平倍照常結算；翻倍要有贏的那一手的牌型才能結算，沒有就退回本金與預扣。

預扣

翻倍可能輸超過本金，所以押翻倍時，平台除了本金，還會從玩家餘額預扣「本金 ×（最高倍數 − 1）」：預設為本金 × 2（開啟特殊牌型的桌為本金 × 4）。開牌後依實際輸贏結算，沒用到的預扣連同派彩一起退回。

翻倍押 1,000（另預扣 2,000）	結算時退回	玩家輸贏
閒牛牛，贏	1,000 + 2,000 + 1,000 × 3 × 0.95 = 5,850	+2,850
閒輸給莊牛8（×2）	1,000 + 2,000 − 2,000 = 1,000	−2,000
閒輸給莊牛3（×1）	1,000 + 2,000 − 1,000 = 2,000	−1,000

餘額不夠本金＋預扣時不能下注；翻倍的限紅指本金，預扣另計。
注單的 hold、bets[].hold 是預扣，payout、bets[].return 含退回的預扣，所以輸贏要用 winLoss（＝payout − stake − hold），見牛牛的注單。
作廢時本金與預扣全額退回。

發牌與開牌

每局一副新牌（52 張），一局用 21 張：先翻開一張頭牌（不算進任何一家），依頭牌點數決定哪一家先發：A、5、9、K 莊，2、6、10 閒一，3、7、J 閒二，4、8、Q 閒三；之後照莊 → 閒一 → 閒二 → 閒三輪流，每家 5 張。
四家的牌面朝下發出，停止下注後依閒一 → 閒二 → 閒三 → 莊逐家開牌。
每局一副新牌，所以沒有「靴」：注單與局結果的 shoe 是場次（預設每 60 局換一場，路單以場次為單位），round 是本場次第幾局。

牛牛的局結果

json

{
  "ok": true,
  "data": {
    "roundId": "01K65N7Q2W4E6R8T0Y1V3J5K7P",
    "tableId": "N01",
    "shoe": "260928-01",
    "round": 7,
    "status": "settled",
    "code": "5893A",
    "cardInfo": "7H|KS QD 10C 3S 5H|4C 6D JS 9C KH|2D 8S QC AH 2C|7D 3H KD 5C 5D",
    "result": {
      "cards": {
        "F": "7H",
        "B-1": "KS", "B-2": "QD", "B-3": "10C", "B-4": "3S", "B-5": "5H",
        "P1-1": "4C", "P1-2": "6D", "P1-3": "JS", "P1-4": "9C", "P1-5": "KH",
        "P2-1": "2D", "P2-2": "8S", "P2-3": "QC", "P2-4": "AH", "P2-5": "2C",
        "P3-1": "7D", "P3-2": "3H", "P3-3": "KD", "P3-4": "5C", "P3-5": "5D"
      },
      "hands": { "B": 8, "P1": 9, "P2": 3, "P3": 10 },
      "winners": { "P1": "P", "P2": "B", "P3": "P" }
    },
    "complete": true,
    "rev": 1,
    "openedAt": "2026-09-28T06:30:05.010Z",
    "settledAt": "2026-09-28T06:30:51.640Z"
  }
}

這一局頭牌 7♥，所以從閒二先發（閒二 → 閒三 → 莊 → 閒一輪流）；開出莊牛8、閒一牛9、閒二牛3、閒三牛牛：閒一、閒三贏，閒二輸。
code、cardInfo 的格式見牛牛的結果碼與牛牛的牌面字串。
result 是資料源送來的結果，格式與資料源介面 GFI 相同；各家輸贏由平台依牌面重算，code 與注單都以重算的結果為準。

有效投注與洗碼量

	百家樂	龍虎
有效投注 `validStake`	莊贏：莊淨贏與閒注相減的絕對值＋和、莊對、閒對（、超級六）的本金；閒贏：閒淨贏與莊注相減的絕對值＋其他同上；和局：只計和、對子（、超級六）	龍贏：龍淨贏與虎注相減的絕對值＋和、同花和；虎贏對稱；和局：和＋同花和＋龍虎實際輸掉的一半。大小單雙每一組（龍大小、龍單雙、虎大小、虎單雙）另加「中的一邊淨贏與另一邊注額相減的絕對值」，開 7 兩邊都輸時為兩邊注額合計
洗碼量 `rolling`	輸掉的注的本金合計（超級六不計）	輸掉的注的本金合計，加上和局時龍虎輸掉的一半

牛牛（niuniu）：有效投注＝平倍的本金＋翻倍的本金 × 實際倍數（bets[].mult，退款的格子不算）；洗碼量＝輸掉的金額（平倍輸本金、翻倍輸本金 × 莊家牌型的倍數）。

作廢的注單有效投注與洗碼量都是 0。

桌檯與局結果 ​

桌檯清單 ​

啟用與停用 ​

其他商戶提供的桌 ​

局的生命週期 ​

查詢局結果 ​

結果碼 ​

牛牛的結果碼 ​

牌面字串 ​

牛牛的牌面字串 ​

結構化結果 ​

投注區與賠率 ​

牛牛 ​

牌型與比牌 ​

投注區與賠率 ​

預扣 ​

發牌與開牌 ​

牛牛的局結果 ​

有效投注與洗碼量 ​

桌檯與局結果

桌檯清單

啟用與停用

其他商戶提供的桌

局的生命週期

查詢局結果

結果碼

牛牛的結果碼

牌面字串

牛牛的牌面字串

結構化結果

投注區與賠率

牛牛

牌型與比牌

投注區與賠率

預扣

發牌與開牌

牛牛的局結果

有效投注與洗碼量