Reporte de Jugadores

GET /api/client/reports/players

Obtenga una lista paginada de jugadores con analíticas integrales incluyendo actividad, resumen financiero, RTP y rentabilidad. La respuesta incluye detalles por jugador y totales agregados de todos los registros coincidentes.

Parámetros de Consulta

Parámetro	Tipo	Requerido	Descripción
page	integer	No	Número de página (por defecto: 1)
filter[per_page]	integer	No	Elementos por página (por defecto: 50)
filter[fromDate]	string	No	Fecha de inicio en formato YYYY-MM-DD
filter[toDate]	string	No	Fecha de fin en formato YYYY-MM-DD
filter[provider_id][]	integer	No	Filtrar por ID(s) de proveedor
filter[currency_id][]	string	No	Filtrar por código(s) ISO de moneda (ej., USD, CRC)
filter[has_transactions]	boolean	No	Solo incluir jugadores con transacciones (true / false)
filter[search]	string	No	Buscar por nombre de usuario del jugador

Combinación de Filtros

Puede combinar múltiples filtros para acotar los resultados. Por ejemplo, para encontrar jugadores activos en USD de un proveedor específico:

?filter[has_transactions]=true&filter[currency_id][]=USD&filter[provider_id][]=5

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/players?page=1&filter[per_page]=50&filter[has_transactions]=true' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Ejemplo con Búsqueda

curl -X GET 'https://api.syssoft1.com/api/client/reports/players?filter[search]=player123' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Ejemplo con Rango de Fechas y Moneda

curl -X GET 'https://api.syssoft1.com/api/client/reports/players?page=1&filter[fromDate]=2026-03-01&filter[toDate]=2026-04-13&filter[currency_id][]=USD&filter[currency_id][]=CRC' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Respuesta

Respuesta Exitosa — 200 OK

{
  "data": [
    {
      "id": 789,
      "username": "player123",
      "client": "inte",
      "country": "CR",
      "currency": "USD",
      "status": true,
      "total_transactions": 450,
      "games_played": 12,
      "total_bets": {
        "raw": 5000.00,
        "formatted": "$5,000.00",
        "large_number": "5K"
      },
      "total_wins": {
        "raw": 4200.00,
        "formatted": "$4,200.00",
        "large_number": "4.2K"
      },
      "total_rollbacks": {
        "raw": 100.00,
        "formatted": "$100.00",
        "large_number": "100"
      },
      "total_free_spins": {
        "raw": 50.00,
        "formatted": "$50.00",
        "large_number": "50"
      },
      "profit": {
        "raw": 650.00,
        "formatted": "$650.00",
        "large_number": "650"
      },
      "rtp": "86.00%",
      "last_activity": "2026-04-13 09:15:00",
      "created_at": "2026-01-15 08:00:00"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total": 45,
    "per_page": 50,
    "total_pages": 1
  },
  "totals": {
    "total_players": 45,
    "total_transactions": 12500,
    "total_bets": {
      "raw": 250000.00,
      "formatted": "$250,000.00",
      "large_number": "250K"
    },
    "total_wins": {
      "raw": 225000.00,
      "formatted": "$225,000.00",
      "large_number": "225K"
    },
    "profit": {
      "raw": 25000.00,
      "formatted": "$25,000.00",
      "large_number": "25K"
    },
    "return_to_player": "90.00%"
  }
}

Campos de la Respuesta

data[] — Registros de Jugadores

Campo	Tipo	Descripción
id	integer	Identificador único del jugador
username	string	Nombre de usuario del jugador
client	string	Identificador del cliente/operador
country	string	Código de país ISO (ej., CR, US)
currency	string	Código ISO de moneda del jugador
status	boolean	Si la cuenta del jugador está activa
total_transactions	integer	Número total de transacciones
games_played	integer	Número de juegos distintos jugados
total_bets	object	Monto total apostado con raw, formatted, large_number
total_wins	object	Monto total ganado con raw, formatted, large_number
total_rollbacks	object	Monto total de rollbacks con raw, formatted, large_number
total_free_spins	object	Monto total de giros gratis con raw, formatted, large_number
profit	object	Ganancia neta de este jugador con raw, formatted, large_number
rtp	string	Porcentaje de Retorno al Jugador
last_activity	string	Marca de tiempo de la última actividad (YYYY-MM-DD HH:mm:ss)
created_at	string	Marca de tiempo de creación de la cuenta (YYYY-MM-DD HH:mm:ss)

pagination — Información de Paginación

Campo	Tipo	Descripción
current_page	integer	Número de página actual
total	integer	Número total de registros
per_page	integer	Registros por página
total_pages	integer	Número total de páginas

totals — Totales Agregados

El objeto totals proporciona valores agregados de todos los registros que coinciden con los filtros actuales (no solo la página actual).

Campo	Tipo	Descripción
total_players	integer	Número total de jugadores que coinciden con los filtros
total_transactions	integer	Suma de todas las transacciones de jugadores
total_bets	object	Apuestas agregadas con raw, formatted, large_number
total_wins	object	Ganancias agregadas con raw, formatted, large_number
profit	object	Ganancia agregada con raw, formatted, large_number
return_to_player	string	Porcentaje de RTP general de todos los jugadores

Entendiendo las Métricas de Jugadores

RTP (Retorno al Jugador)

El campo rtp representa el porcentaje del total de apuestas que fue devuelto al jugador como ganancias y rollbacks.

Fórmula: (total_wins + total_rollbacks) / total_bets * 100

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

Ganancia

El campo profit representa el ingreso neto generado por el jugador.

Fórmula: total_bets - total_wins - total_rollbacks

Estado

El campo status indica si la cuenta del jugador está actualmente activa (true) o inactiva (false). Los jugadores inactivos pueden seguir apareciendo en reportes históricos.

Pruébelo

⚡API PlaygroundGET

URL Base

X-Client-Secret *

Parámetros

pageinteger

Page number

filter[per_page]integer

Items per page

filter[fromDate]string

Start date (YYYY-MM-DD)

filter[toDate]string

End date (YYYY-MM-DD)

filter[provider_id][]array

Provider IDs

filter[currency_id][]string

Currency ISO codes

filter[has_transactions]boolean

Only players with transactions

Only players with transactions

filter[search]string

Search by username

URL de Petición

https://api.syssoft1.com/api/client/reports/players

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 tipos y formatos de los parámetros.
429	Límite de solicitudes excedido. Espere y reintente. Consulte Manejo de Errores.