Reporte de Juegos Diarios

GET /api/client/reports/daily-games

Obtenga una lista clasificada de juegos basada en métricas de rendimiento. Los juegos son puntuados y organizados en niveles de desempeño, facilitando la identificación de los títulos con mejor y peor rendimiento.

Niveles de Rendimiento

Los juegos se clasifican según una puntuación de rendimiento propietaria y se asignan a niveles:

Nivel	Ranking	Descripción
Diamond	1-3	Juegos con mejor rendimiento
Emerald	4-6	Rendimiento excelente
Platinum	7-9	Rendimiento sólido
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

Parámetros de Consulta

Parámetro	Tipo	Requerido	Descripción
filter[fromDate]	string	No	Fecha de inicio en formato YYYY-MM-DD (por defecto: ayer)
filter[toDate]	string	No	Fecha de fin en formato YYYY-MM-DD (por defecto: hoy)
filter[provider_id][]	integer	No	Filtrar por ID(s) de proveedor

Rango de Fechas por Defecto

Si no se especifica un rango de fechas, la API devuelve datos de las últimas 24 horas (de ayer a hoy).

Solicitud

Headers

Header	Valor	Requerido
Accept	application/json	Sí
X-Client-Secret	Su UUID secret	Sí

Ejemplo de Solicitud

curl -X GET 'https://api.syssoft1.com/api/client/reports/daily-games?filter[fromDate]=2026-03-15&filter[toDate]=2026-04-13' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Ejemplo con Filtro de Proveedor

curl -X GET 'https://api.syssoft1.com/api/client/reports/daily-games?filter[fromDate]=2026-04-01&filter[toDate]=2026-04-13&filter[provider_id][]=5&filter[provider_id][]=12' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Respuesta

Respuesta Exitosa — 200 OK

{
  "data": [
    {
      "game_id": 42,
      "game_name": "Sweet Bonanza",
      "provider": "Pragmatic Play",
      "currency_iso": "USD",
      "unique_players": 85,
      "total_transactions": 2400,
      "total_bets": {
        "raw": 25000.00,
        "formatted": "$25,000.00",
        "large_number": "25K"
      },
      "total_wins": {
        "raw": 22000.00,
        "formatted": "$22,000.00",
        "large_number": "22K"
      },
      "calculated_profit": 3000.00,
      "score": 95.5,
      "ranking": 1,
      "tier": "diamond",
      "rank_in_tier": 1,
      "previous_ranking": 2,
      "rank_change": 1,
      "acceptance_rate": 45.2,
      "total_provider_players": 188
    }
  ]
}

Campos de la Respuesta

data[] — Registros de Juegos

Campo	Tipo	Descripción
game_id	integer	Identificador único del juego
game_name	string	Nombre para mostrar del juego
provider	string	Nombre del proveedor de juegos
currency_iso	string	Código ISO de moneda para los valores monetarios
unique_players	integer	Número de jugadores distintos que jugaron este juego
total_transactions	integer	Número total de transacciones para este juego
total_bets	object	Monto total apostado con raw, formatted y large_number
total_wins	object	Monto total ganado con raw, formatted y large_number
calculated_profit	number	Ganancia neta (apuestas menos ganancias)
score	number	Puntuación de rendimiento utilizada para el ranking
ranking	integer	Posición general en el ranking
tier	string	Nivel de rendimiento: diamond, emerald, platinum, gold, silver, bronze, iron
rank_in_tier	integer	Posición dentro del nivel (1-3)
previous_ranking	integer	Ranking en el período anterior
rank_change	integer	Cambio en el ranking (positivo = mejoró, negativo = bajó)
acceptance_rate	number	Porcentaje del total de jugadores del proveedor que jugaron este juego
total_provider_players	integer	Número total de jugadores del proveedor

Objetos Monetarios

Todos los valores monetarios en la respuesta utilizan un formato consistente:

Campo	Tipo	Descripción
raw	number	Valor numérico en crudo para cálculos
formatted	string	Cadena formateada con símbolo de moneda
large_number	string	Representación abreviada (ej., 25K, 1.2M)

Entendiendo los Rankings

Puntuación

La score es una métrica compuesta calculada a partir de múltiples factores incluyendo apuestas totales, jugadores únicos, volumen de transacciones y margen de ganancia. Puntuaciones más altas indican mejor rendimiento del juego.

Cambio de Ranking

El campo rank_change muestra cómo ha cambiado la posición del juego en comparación con el período anterior:

• Valor positivo (ej., 1): El juego subió en el ranking.
• Valor negativo (ej., -2): El juego bajó en el ranking.
• Cero (0): El juego mantuvo su posición.

Tasa de Aceptación

La acceptance_rate representa el porcentaje de la base total de jugadores de un proveedor que jugó este juego específico. Una tasa de aceptación más alta indica un atractivo más amplio para los jugadores dentro del catálogo del proveedor.

Fórmula: (unique_players / total_provider_players) * 100

Pruébelo

⚡API PlaygroundGET

URL Base

X-Client-Secret *

Parámetros

filter[fromDate]string

Start date (YYYY-MM-DD)

filter[toDate]string

End date (YYYY-MM-DD)

filter[provider_id][]array

Provider IDs

URL de Petición

https://api.syssoft1.com/api/client/reports/daily-games

Respuestas de Error

Código	Descripción
401	Client secret inválido o inactivo. Consulte Autenticación.
422	Parámetros de consulta inválidos. Verifique los formatos de fecha e IDs de proveedor.
429	Límite de solicitudes excedido. Espere y reintente. Consulte Manejo de Errores.