Glosario

Una guía de referencia para la terminología utilizada en la documentación de la API.

Tipos de Transacción

DEBIT

Una apuesta realizada por un jugador. Representa dinero que fluye del jugador hacia la plataforma. En los resúmenes financieros, la suma de todos los débitos equivale al monto total apostado.

CREDIT

Una ganancia o pago otorgado a un jugador. Representa dinero que fluye de la plataforma de vuelta al jugador. Los créditos reducen la ganancia del operador.

ROLLBACK

Una transacción cancelada o revertida. Los rollbacks ocurren cuando una ronda de juego es anulada o una transacción necesita ser deshecha. Los fondos son devueltos al saldo del jugador. Los rollbacks reducen la ganancia del operador.

FREE_SPIN

Una transacción de giro gratis promocional. Son giros promocionales proporcionados a los jugadores sin costo. Cualquier ganancia de los giros gratis se paga como créditos. El valor del giro gratis representa el monto de apuesta nominal asignado por el proveedor.

Métricas Financieras

RTP (Retorno al Jugador)

El porcentaje del total de apuestas que se devuelve a los jugadores como ganancias y rollbacks. Una métrica clave para entender la rentabilidad del juego tanto desde la perspectiva del operador como del jugador.

Fórmula:

RTP = (total_wins + total_rollbacks) / total_bets * 100

Ejemplo: Si un jugador apuesta $1,000, gana $850 y tiene $20 en rollbacks:

RTP = ($850 + $20) / $1,000 * 100 = 87.00%

Un RTP más bajo significa mayor rentabilidad para el operador.

Ganancia (Profit)

Ingreso neto generado por la actividad de juego. Es el monto retenido por el operador después de pagar ganancias y procesar rollbacks.

Fórmula:

Profit = total_bets - total_wins - total_rollbacks

Ejemplo: Si las apuestas totales son $10,000, las ganancias totales son $8,500 y los rollbacks totales son $200:

Profit = $10,000 - $8,500 - $200 = $1,300

Rankings de Juegos

Nivel (Tier)

Una categoría de clasificación para juegos basada en su puntuación de rendimiento. Los juegos se clasifican de mejor a peor y se agrupan en niveles:

Nivel	Rankings	Significado
Diamond	1-3	Juegos con mejor rendimiento y puntuaciones más altas
Emerald	4-6	Rendimiento excelente, cerca del tope
Platinum	7-9	Rendimiento sólido, consistentemente buenos
Gold	10-12	Rendimiento superior al promedio
Silver	13-15	Rendimiento promedio
Bronze	16-18	Rendimiento inferior al promedio
Iron	19-21	Juegos con menor ranking en el período de evaluación

Puntuación (Score)

Una métrica numérica compuesta calculada a partir de múltiples factores incluyendo apuestas totales, jugadores únicos, volumen de transacciones y margen de ganancia. La puntuación determina el ranking general y la ubicación en el nivel del juego.

Tasa de Aceptación (Acceptance Rate)

El porcentaje de la base total de jugadores de un proveedor que jugó un juego específico durante el período de evaluación. Esta métrica indica qué tan ampliamente atractivo es un juego dentro del catálogo de su proveedor.

Fórmula:

Acceptance Rate = (unique_players / total_provider_players) * 100

Ejemplo: Si un proveedor tiene 200 jugadores totales y 50 de ellos jugaron un juego específico:

Acceptance Rate = (50 / 200) * 100 = 25.00%

Cambio de Ranking (Rank Change)

La diferencia entre el ranking actual de un juego y su ranking en el período anterior. Un valor positivo indica mejora; un valor negativo indica declive.

Formato de Valores Monetarios

Todos los valores monetarios en la API se devuelven en un formato de objeto consistente:

Campo	Tipo	Descripción
raw	number	El valor numérico en crudo, apto para cálculos
formatted	string	Cadena formateada con símbolo de moneda (ej., $5,000.00)
large_number	string	Formato abreviado legible (ej., 5K, 1.2M)

Términos Generales

Cliente (Client)

Un operador o plataforma que se integra con el agregador de juegos. Cada cliente tiene un secret único para la autenticación de la API.

Proveedor (Provider)

Un proveedor de contenido de juegos (ej., Pragmatic Play, Evolution Gaming). Los proveedores suministran los juegos disponibles en la plataforma.

Código ISO de Moneda

Un código de tres letras que sigue el estándar ISO 4217 que identifica una moneda. Ejemplos comunes: USD (Dólar estadounidense), EUR (Euro), CRC (Colón costarricense).

Paginación

Un método para dividir conjuntos de resultados grandes en páginas más pequeñas. La API devuelve un objeto pagination con current_page, total, per_page y total_pages para ayudar a navegar a través de los resultados.