Changelog

The tenant API version is part of the URL (/api/tenant/v1). v1 is backward compatible: new endpoints, fields and error codes are compatible changes, so make your code ignore fields it does not know. Breaking changes only come with a new major version, and deprecations are announced here and in the Console at least 90 days in advance.

v1.4.0 — 2026-10-05

Compatible change (a new variant and new bet zone codes; make your code accept a variant or zone it does not know).

• Texas Hold'em player vs dealer adds the variant thbp (Texas Hold'em Bonus Poker; platform simulated table H03, enabled in the sandbox): bet zones ANTE (ante), FLOP (flop bet, 2× the ante), TURN (turn bet, 1× the ante), RIVER (river bet, 1× the ante) and BONUS (bonus bet). result.code is player_wins, dealer_wins, tie or fold (no dealer_not_qualified). See Tables and rounds for the rules and default pay table.

v1.3.0 — 2026-09-28

Compatible change (a new game, new bet zones, fields and GFI events; make your code accept a game, zone or field it does not know).

• Live Niu Niu (game: "niuniu", variant: "standard"; platform simulator table N01, enabled for sandboxes): the dealer's banker hand against player 1, player 2 and player 3, with bet zones P1E, P2E, P3E (equal) and P1D, P2D, P3D (double). See Tables and rounds for the rules, multipliers and the hold.
• Bet records (GET /bets, webhooks bet.settled, round.corrected, round.voided): Niu Niu slips add hold (the total hold on double bets), double bets in bets[] add hold and mult, and result adds hands and winners. payout includes the returned hold, so always take the win/loss from winLoss (= payout − stake − hold); see Bets.
• Result code and card string: a Niu Niu code has 5 characters (for example 5893A) and cardInfo is first card|banker|player 1|player 2|player 3; the result of GET /rounds/{roundId} is the structured Niu Niu result. See Tables and rounds.
• GET /bets/summary: Niu Niu slips count towards payout as stake + win/loss, without the returned hold.
• GFI data-source interface: game: "niuniu" with positions F (first card), B-1 to B-5 and P1-1 to P3-5; card gets an optional faceDown (dealt face down, kept secret until revealed); a new reveal event turns hands over one by one. See Events & data model.

v1.2.0 — 2026-09-27

Compatible change (a new game, new bet zones and fields; make your code accept a game, zone or field it does not know).

• Texas Hold'em (game: "holdem"): variants casino (player vs dealer) and nlhe (player vs player); bet zones ANTE, CALL, AAB, POT. Bet records (GET /bets, webhook bet.settled) add rake, onsite and hand; see Bets for the result format.
• GET /bets/summary adds rake per player (rake from Texas Hold'em player-vs-player tables).
• Cross-merchant sharing: GET /tables also lists tables other merchants share with you (with provider); enable and disable them like platform tables, see Tables and rounds.

v1.1.0 — 2026-09-25

Compatible change (new bet zone codes; make your code accept a zone it does not know).

• Dragon tiger adds big/small/odd/even zones: DB dragon big, DS dragon small, DO dragon odd, DE dragon even, TB tiger big, TS tiger small, TO tiger odd, TE tiger even. They are offered only on dragon tiger tables where you turn them on in Console "Table settings" (off by default); see Tables and rounds for rules and odds. Bet records (GET /bets, webhook bet.settled) may contain these codes in bets[].zone.
• When a result has no cards (GFI complete: false), suited-tie and big/small/odd/even bets are refunded in full.

v1.0.0 — 2026-09-24

First release.

Tenant API

• Authentication: HMAC-SHA256 signatures (X-Api-Key, X-Timestamp, X-Nonce, X-Signature), a ±300 second time window, 10-minute nonce replay protection, IP allowlist and per-tenant rate limits.
• Players: POST /player/launch (one-time 60-second launch URL, automatic player creation, single session), POST /player/logout, GET /player, POST /player/update.
• Transfer wallet: POST /wallet/deposit and POST /wallet/withdraw (idempotent on txnId), GET /wallet/transfer, GET /wallet/balance.
• Bets: GET /bets (cursor-based incremental sync with rev revisions), GET /bets/summary (daily per-player totals).
• Tables and rounds: GET /tables, POST /tables/enable, POST /tables/disable, GET /rounds/{roundId}.
• Account: GET /account, GET /account/usage, GET /account/statements.

Webhooks

• Round events bet.settled, round.corrected and round.voided (slips in the same shape as GET /bets), the player event player.kicked, the account events account.grace, account.downgraded, account.restored, account.topup and account.low_balance, and test.
• X-Elite-Signature HMAC signatures; retries with exponential backoff for about 24 hours. Sandbox tenants also send round events.

Data source interface

• GFI v1: WebSocket and HTTPS batch transports, resume, de-duplication, gap resync, result consistency checks and a dry-run validation endpoint.

Docs and tools

• This site (繁體中文, English, 简体中文), the OpenAPI 3.1 spec, Postman collections, the signature debugger and the GFI event validator.

Planned

• Seamless wallet: the platform calls your wallet endpoints when bets are placed and settled. For Niu Niu double bets, the debit when a bet is placed includes the hold, and the credit at settlement includes the returned hold.