Notell API Docs
Русский

Features

Bet limits and extended bets

Every paid round is checked against bet limits before the debit. A stake outside the limits is refused with PROJECT_BET_LIMIT and nothing is debited. Limits are set per currency and expressed per spin (the total stake of the round, including a bonus buy price).

Three layers#

LayerSet whereScope
Project tableAdmin → Projects → project → Bet managementThe whole project; can be narrowed by provider and by game
Per-game limit (RTP settings)Admin → RTP & players → Bet limits per gameOne game of the project, per currency
Player limitAdmin → RTP & players → player → Player bet limit, or POST /playerRtp.do action bet-limitOne player, per currency (and provider)

Project table: which entry applies#

The most specific table wins: game → provider → default. A table that has no entry for the round's currency falls through to the next less specific one. If no table has the currency, there is no project limit: any bet the game offers is accepted.

Each entry is a minimum (optional, at least one minor unit) and a maximum per spin. In the admin panel amounts are typed in major units with two decimals (for example 0.10 and 100); the stored values are minor units.

Effective maximum#

All applicable layers are enforced together. For a given player, game and currency the effective per-spin maximum is the smallest of:

  1. the project table maximum (game → provider → default),
  2. the per-game limit of the RTP settings,
  3. the player's own maximum.

The minimum of each layer is enforced too, and a free-spins bet is checked against the project limits when the grant is created.

Extended bets#

Each game has a native bet table. An admin maximum below it simply restricts the table. An admin maximum above the game's native maximum makes extended bets available: extra bet levels above the native ones, up to the effective maximum.

  • The extended levels are offered in the game's initial configuration when the game loads. A change of limits therefore reaches a player when the game is opened or reloaded.
  • At most 12 extra levels are offered; if more fit, they are spread evenly and the list always reaches the highest level that fits the limit.
  • The platform accepts the offered levels for every game; the limit is still enforced before the debit with the real stake, so a level above the effective maximum is refused.
  • Native bets and everything the game does for them are unchanged. Wins scale linearly with the stake.

The ladder per provider#

ProviderWhat is extendedLadder
Pragmatic PlayThe per-line coin above the game's largest native coinCoin values 1, 1.5, 2, 2.5, 3, 4, 5, 6, 7.5 × 10<sup>k</sup> (money units); the stake is coin × lines and must not exceed the effective maximum. Coin ceiling: 1 000 000 000.00
Nolimit CityThe bet level above the game's largest native levelk × the largest native level, with k = n × 10^j, n in 1, 2, 3, 4, 5, 6, 8, 15, 25, 75, j ≥ 0, k ≥ 2 (so 2, 3, 4, 5, 6, 8, 10, 15, 20, 25, 30, …)
EndorphinaThe denomination above the game's largest native denominationk × the largest native denomination, with the same k ladder; the smallest stake of the extended denomination must fit the limit

For Nolimit City and Endorphina the stake of an extended bet is capped at 100 000 000 000.00 in the currency.

Worked examples#

Pragmatic Play. Largest native coin 10.00, 10 lines (largest native bet 100.00). The effective maximum is 1 000.00 per spin → maximum coin 100.00. Coins above 10.00 and up to 100.00 on the ladder are 15, 20, 25, 30, 40, 50, 60, 75, 100 — nine extended coins (fewer than 12, so all are offered). The largest total bet becomes 1 000.00.

Nolimit City. Largest native bet level 100.00; the effective maximum is 1 000.00 → k up to 10: 2, 3, 4, 5, 6, 8, 10 → extended levels 200, 300, 400, 500, 600, 800, 1 000.

Per currency. Limits are per currency: a maximum of 1 000.00 for EUR says nothing about UAH. Set a table for every currency you use, or rely on the default table.

Free spins and extended bets#

When you grant free spins in the admin panel, the bet picker lists the game's native bets and — if the project maximum of the currency is above the native maximum — the extended bets up to it.

Player limits#

A personal limit applies together with the project limits (the smallest maximum wins). Set it:

  • in the admin panel (RTP & players, choose a player, Player bet limit — the same limit is written for every provider), or
  • with POST /playerRtp.do:
bash
curl -s -X POST https://notell-api.com/playerRtp.do \
  -H 'Content-Type: application/json' \
  -d '{
    "partner": "YOUR_PARTNER_ID",
    "api_key": "YOUR_API_KEY",
    "action": "bet-limit",
    "player_id": "player-123",
    "provider": "pragmatic",
    "currency": "EUR",
    "min_minor": "10",
    "max_minor": "5000"
  }'

Send null for both min_minor and max_minor to remove the limit. Minor units are strings: "5000" = 50.00. More about the endpoint: RTP management.

Troubleshooting#

SymptomLikely cause
PROJECT_BET_LIMIT for a bet the game offersOne of the three layers has a narrower range for that currency; check the player's limit and the per-game limit as well as the project table
Extended bets do not appearThe effective maximum is not above the game's native maximum, or no table covers the currency
Free-spins creation fails with PROJECT_BET_LIMITbet is outside the project limits for that currency
Documentation for operators and integrators.TEST_ONLY platform: non-withdrawable units, no real payments.