> For the complete documentation index, see [llms.txt](https://rubble.gitbook.io/betvio777-api-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rubble.gitbook.io/betvio777-api-guide/getting-started/quickstart.md).

# Quickstart

### Introduction <a href="#introduction" id="introduction"></a>

Our **Casino API** offers seamless integration with a diverse collection of over **2,000 slot games**  providing a premium gaming experience. \
The slot library features top-tier titles from renowned providers like **Pragmatic Play** and **PG Soft**, ensuring high-quality graphics, engaging gameplay, and fair outcomes. \
With an extensive selection of popular and trending slot games, players are guaranteed to find their favorites. \
The live casino section is powered exclusively by **Pragmatic Play Live**, delivering an authentic and immersive experience with professional dealers and real-time streaming.

Our API ensures fast and secure transactions, smooth gameplay, and reliable performance across all platforms.

It's designed for easy integration, allowing operators to expand their offerings quickly and efficiently.&#x20;

Elevate your gaming platform with our comprehensive Casino API and give your players an unmatched gaming experience.

{% hint style="info" %}
*Unfamiliar with the Casino API?* \
*Start by understanding the* [*GGR percentage*](#explaining-ggr)
{% endhint %}

### Explaining GGR % <a href="#explaining-ggr" id="explaining-ggr"></a>

An **agent** (which can be an API reseller or an online casino operator) is required to purchase an **API balance** from us to facilitate game operations.

For example, if **Agent A** has a revenue share of **10%**, they can purchase an API balance of **$1,000** by paying only **$100** in real cash.&#x20;

This allows Agent A to generate up to **$1,000** in revenue from user gameplay using our games.

> At a 10% GGR rate, if an agent deposits 100 USDT and their currency is <kbd>IDR</kbd>, with the USD to IDR exchange rate set at 16,000, the calculation for the API balance in IDR would be:
>
> **API Balance (IDR) = (Deposit Amount / GGR Rate) \* 100 \* (USD to IDR Rate)**
>
> Using the given values:
>
> **API Balance (IDR) = (100 / 10) \* 100 \* 16,000 = 16,000,000 IDR.**
>
> Thus, the agent would receive a balance of 16 million IDR in the API.

Agents also have the ability to create **sub-agents** for their clients.&#x20;

Sub-agents will purchase API balance directly from the agent, and their **GGR (Gross Gaming Revenue) percentage** will typically be higher than the agent's percentage, creating an additional profit margin.

The **GGR percentage** can be adjusted dynamically based on ongoing performance and business needs, allowing for flexible revenue management and strategic growth.

#### **API Balance Calculation** <a href="#api-balance-calculation" id="api-balance-calculation"></a>

As users engage with the games, the API balance will decrease based on the formula: \
**User Total Bet – User Total Win = Agent Win**

For example:

* If the total bet from users is 1000 BRL and the total win is 800 BRL, the API balance will be decreased by 200 BRL.
* This means you earned 200 BRL from the users.

#### **GGR Share** <a href="#ggr-share" id="ggr-share"></a>

Based on the 200 BRL earned, the GGR share percentage will apply.&#x20;

If the share is 8%, you will pay 8% for API usage.

### Strategic Control of RTP <a href="#strategic-control-of-rtp" id="strategic-control-of-rtp"></a>

#### Enhancing Player Engagement <a href="#enhancing-player-engagement" id="enhancing-player-engagement"></a>

**Strategic Control of RTP** allows operators to adjust the **Return to Player (RTP)** rate to balance profitability with player satisfaction.&#x20;

By fine-tuning RTP, operators can create a more engaging gaming experience, ensuring that players feel rewarded while maintaining a healthy house edge.&#x20;

This strategic approach helps increase player retention, extend session times, and ultimately drive higher long-term revenue.

#### Dynamic RTP Range <a href="#dynamic-rtp-range" id="dynamic-rtp-range"></a>

The **RTP (Return to Player)** can be fully customized to align with your business strategy.&#x20;

It can be configured at the **platform level** to apply across your entire website or tailored to individual player profiles for a more personalized experience.&#x20;

The RTP range is flexible, allowing adjustments between **1% and 95%** to balance player engagement and profitability effectively.

### Free Spins Incentives <a href="#free-spins-incentives" id="free-spins-incentives"></a>

Casino operators drive player acquisition by incentivizing with bonus spins or free spins.&#x20;

Bonuses and free spins can boost player acquisition and engagement.&#x20;

This strategy promotes the casino business and supports player retention.

### Agent Jackpot Mechanism <a href="#agent-jackpot-mechanism" id="agent-jackpot-mechanism"></a>

The Agent Jackpot is designed to regulate and balance the agent’s Return to Player (**Agent RTP**) by distributing winnings to randomly selected players.&#x20;

This system helps ensure that the agent's overall RTP target is maintained, even if individual player outcomes vary.

#### **How It Works:** <a href="#how-it-works" id="how-it-works"></a>

1. **Current RTP Logic Issue**: In the standard RTP model, if all users lose consistently, the site retains the balance, and no players are able to withdraw their winnings.
2. **Agent Jackpot Adjustment**: The Agent Jackpot System ensures that the agent's overall RTP (based on total user bets and total user wins) is balanced.
3. **Reward Distribution**:
   * If individual user wins are too low to meet the agent’s RTP target, selected users may receive large rewards drawn from the total pool of user bets.
   * This mechanism increases the agent's RTP by ensuring that some players win substantial amounts, thereby balancing the overall payout rate.

#### **Purpose:** <a href="#purpose" id="purpose"></a>

* To prevent prolonged losing streaks across all players.
* To stabilize the agent's RTP by selectively awarding large payouts from the overall player pool.
* Functions as a reward system to maintain player engagement and ensure fair payout distribution.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://rubble.gitbook.io/betvio777-api-guide/getting-started/quickstart.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.