Other endpoints

Endpoints

Common rules

• Sign requests as described in Authentication. Write requests (PUT, POST) also need X-Request-Id.
• site_id is always the site code, e.g. site_mrd01. A key bound to a site sees only its own site and writes only to it.
• Amounts in responses are JSON numbers with two decimals, e.g. 0.20.
• Shared data is the same in Test and Live: a change made with a Test key also applies on Live. See Environments.
• Errors that any signed endpoint can return (INVALID_SIGNATURE, TIMESTAMP_SKEW, IP_NOT_ALLOWED, SCOPE_MISSING, RATE_LIMITED, and on writes 422 and 409 for X-Request-Id) are on the Error codes page. Codes specific to this page are in the table at the bottom.

Effective limits

GET /v1/limits · scope games.read. Returns the limits a launch of the game would get on the site: all rules and the market cap applied.

{
  "currency": "USD",
  "min_bet": 0.20,
  "max_bet": 50.00,
  "default_bet": 1.00,
  "source": { "min_bet": "platform", "max_bet": "site" }
}

Limit order

Layers apply from top to bottom. Each layer can only narrow the range above it: min_bet only goes up and max_bet only goes down. A layer that would leave an empty range is ignored. default_bet comes from the last layer that sets one and is fitted into the range; if no layer sets one, it is min_bet. Boss Hub manages the platform layers; the operator and site layers are yours.

Your limit rules

GET /v1/limits/rules · scope games.read. Takes no parameters. Returns the limit rules of your operator and sites: operator rules first, then site rules. Platform rules are not listed. A site key sees only the rules of its own site.

Writing a limit rule

PUT /v1/limits/rules · scope limits.write. Writes one rule: one target, one level (operator or site), one currency. The rule is created if missing, updated otherwise. The response is {"changed": true}, or false if nothing changed.

{
  "scope": "game",
  "ref": "sultans-ember",
  "site_id": "site_mrd01",
  "currency": "USD",
  "min_bet": 0.20,
  "max_bet": 50.00,
  "default_bet": 1.00
}

Availability

GET /v1/availability · scope games.read. Returns the resolved state, per site, of every provider open to you and of its games. It is the same check as launch and runs in your key’s environment.

[
  { "scope": "provider", "ref": "boss-originals", "site_id": "site_mrd01", "enabled": true, "source": null },
  { "scope": "game", "ref": "sultans-ember", "site_id": "site_mrd01", "enabled": false, "source": "operator_rule" }
]

Opening and closing rule

PUT /v1/availability/rules · scope availability.write. Writes your decision for a provider or a game: operator-wide or for one site. The response is {"changed": true}, or false if the state was already the same.

Lobby categories

GET /v1/lobby/categories · scope games.read. Returns the lobby categories in order.

[
  {
    "key": "featured",
    "name": { "tr": "Öne çıkanlar", "en": "Featured" },
    "mode": "manual",
    "auto_rule": null,
    "games": ["sultans-ember", "cyber-djinn"]
  },
  {
    "key": "new",
    "name": { "tr": "Yeni oyunlar", "en": "New games" },
    "mode": "auto",
    "auto_rule": "new_30d",
    "games": ["cyber-djinn"]
  }
]

Saving lobby categories

PUT /v1/lobby/categories · scope lobby.write. The body is the full list of categories (a JSON array) and replaces the whole target set: operator-wide, or the site in site_id. The list order is the lobby order. The response is the saved set, in the GET format.

Marketing assets

GET /v1/marketing/assets · scope marketing.read. Lists the asset packs of games in your library. The pack of an announced game appears 14 days before its release.

[
  {
    "game_id": "sultans-ember",
    "zip_url": "https://api.example.com/…/packs/sultans-ember.zip?op=…&exp=1762344900&sig=…",
    "files": [
      {
        "kind": "banner",
        "size": "1920x600",
        "locale": null,
        "name": "sultans-ember_banner_1920x600.png",
        "url": "https://api.example.com/files/fil_01HF3K9QZ2?exp=1762344300&sig=5d0e8b13"
      },
      {
        "kind": "copy",
        "size": null,
        "locale": "en",
        "name": "sultans-ember_copy_en.txt",
        "url": null
      }
    ]
  }
]

Daily reconciliation

GET /v1/reconciliation/daily · scope reconciliation.read. Compares our totals for one UTC day with the totals you sent, one row per currency. Operator keys only: a site key gets 403 SCOPE_DENIED.

[
  {
    "date": "2026-11-05",
    "currency": "USD",
    "provider_side": { "bets": 51240.00, "wins": 49190.40, "rounds": 19377, "transactions": 39102 },
    "operator_side": { "bets": 51240.00, "wins": 49185.40, "rounds": 19377, "transactions": null },
    "difference": -5.00,
    "status": "mismatch"
  }
]

Sending daily totals

POST /v1/reconciliation/daily?date=YYYY-MM-DD · scope reconciliation.write. You send your own totals for one day and currency. The response is the compared row: 200, a single object in the format above. Sending again for the same day and currency replaces your previous totals and reopens a difference closed manually in the portal. Operator keys only.

{
  "currency": "USD",
  "bets": 51240.00,
  "wins": 49185.40,
  "rounds": 19377
}

Wallet health

GET /v1/wallet-health · scope wallet_health.read. Returns the performance of the callbacks we sent to your wallet, in your key’s environment. Test suite and connection test calls are not counted. Status thresholds come from your account’s wallet alert rules, or the platform defaults.

{
  "p50_ms": 75,
  "p95_ms": 250,
  "error_rate": 0.0004,
  "timeout_rate": 0.0001,
  "by_call": [
    { "call": "authenticate", "count": 1204, "p95_ms": 150, "error_rate": 0 },
    { "call": "balance", "count": 3310, "p95_ms": 125, "error_rate": 0 },
    { "call": "bet", "count": 18420, "p95_ms": 250, "error_rate": 0.0005 },
    { "call": "win", "count": 6120, "p95_ms": 200, "error_rate": 0.0002 },
    { "call": "rollback", "count": 12, "p95_ms": 300, "error_rate": 0 }
  ],
  "hourly": [
    { "hour": "2026-11-04T15:00:00.000Z", "status": "ok" },
    { "hour": "2026-11-04T16:00:00.000Z", "status": "warn" }
  ]
}

Live stream

GET /v1/live/stream · scope rounds.read · live module. A Server-Sent Events stream (text/event-stream) that sends your rounds as they close, in your key’s environment. Sign the request like any GET; the connection then stays open.

: ok

event: round.closed
data: {"id":"rnd_01HF3K9QZ2","site_id":"site_mrd01","player_id":"u_88213","game_id":"sultans-ember","currency":"USD","bet":2.00,"win":150.00,"status":"closed","kind":"normal","has_jackpot":false,"closed_at":"2026-11-05T14:22:09.000Z"}

event: round.big_win
data: {"id":"rnd_01HF3K9QZ2","site_id":"site_mrd01","player_id":"u_88213","game_id":"sultans-ember","currency":"USD","bet":2.00,"win":150.00,"status":"closed","kind":"normal","has_jackpot":false,"closed_at":"2026-11-05T14:22:09.000Z"}

: ping

Player events

POST /v1/player-events · scope player_events.write. Optional. Records a deposit, withdrawal or signal for a player who has already opened a game in this environment. The response is 201 with the event ID. If you do not send events, the metrics below stay empty.

{
  "player_id": "u_88213",
  "site_id": "site_mrd01",
  "type": "deposit",
  "amount": "25.00",
  "currency": "USD",
  "occurred_at": "2026-11-05T14:30:00Z"
}

{
  "id": "pev_01HF3Q2M8V"
}

Error codes