Carregando
Documentação técnica

API de Viciados Automáticos

Consulte os grupos, dezenas, centenas ou milhares que mais se repetem em uma loteria, com ranking por quantidade de ocorrências, percentual e última saída.

LI
Versão da documentação 1.0 Maio/2026
Métodos: GET / POST
Autenticação: Bearer Token
Cálculo: Frequência histórica
Retorno: JSON
01

Visão geral

A API de Viciados Automáticos calcula quais valores mais aparecem no histórico de uma loteria. O ranking pode ser gerado para grupo, dezena, centena ou milhar, considerando todas as posições do 1º ao 5º prêmio ou apenas uma posição específica.

Ranking por frequência Ordena do valor mais recorrente para o menos recorrente.
Percentual Mostra a participação do item dentro do total analisado.
Última saída Retorna a última data em que o item apareceu.
02

Ferramentas disponíveis no painel

Status da API

Exibe se o módulo está ativo, pausado ou bloqueado administrativamente.

Token Bearer

Permite visualizar e alterar o token usado nas consultas.

Limite de requisições

Mostra o limite contratado e a quantidade de consultas realizadas.

Pausar loterias

Permite inativar loterias específicas para bloquear consultas.

Pausar modalidades

Permite bloquear grupo, dezena, centena ou milhar.

Histórico de consultas

Registra payloads, IPs, data e quantidade de consultas.

03

Início rápido

  1. Copie seu Bearer Token no painel da API de Viciados.
  2. Escolha a loteria usando a sigla cadastrada, por exemplo rj.
  3. Escolha o tipo de busca: grupo, dezena, centena ou milhar.
  4. Opcionalmente informe posição e extração. Se não informar, o padrão será posicao=1-5 e todas as extrações da loteria.
Consulta rápida via GET
curl -X GET 'https://api.lotoserv.com/viciados/consulta/v1/?loteria=rj&tipo_busca=grupo&posicao=1-5&extracao=21' \
  -H 'Authorization: Bearer 25022FE61F971C203AE0ACBB'
04

Autenticação

Todas as consultas devem enviar o token no header Authorization usando o formato Bearer.

Header obrigatório
Authorization: Bearer 25022FE61F971C203AE0ACBB
Caso o token não seja enviado, esteja em formato incorreto ou seja inválido, a API retornará erro 401.
05

Endpoint

O endpoint aceita requisições GET ou POST. No POST, os dados podem ser enviados como application/json ou formulário comum.

GET / POST https://api.lotoserv.com/viciados/consulta/v1/
Verificação simples de status
https://api.lotoserv.com/viciados/consulta/v1/?tipo_conexao=verificar_status
06

Parâmetros da consulta

Parâmetro Obrigatório Valores aceitos Descrição
loteria Sim Sigla da loteria. Ex: rj, sp, fd Define em qual loteria os viciados serão calculados.
tipo_busca Sim grupo, dezena, centena, milhar Define a modalidade de frequência que será retornada.
posicao Não 1, 2, 3, 4, 5, 1-5 Define qual posição de prêmio será considerada. Padrão: 1-5.
extracao Não 00 até 23 Filtra por uma extração específica. Se não informado, considera todas as extrações da loteria.
Quando extracao não é informado, a API calcula os viciados considerando todas as extrações disponíveis para a loteria selecionada.
07

Tipos de busca

Tipo Aliases aceitos Retorno Limite padrão
Grupo g, grupo, grupos grupo, animal, emoji, quadra 25 registros
Dezena dz, d, dezena, dezenas dezena 100 registros
Centena c, centena, centenas centena 1.000 registros
Milhar m, milhar, milhares milhar 1.000 registros
08

Resposta JSON

O retorno é dividido em três blocos principais: usuario, consulta, informacoes e dados.viciados.

Campo Descrição
usuarioDados do terminal, site/app e cliente.
consultaNúmero da consulta, data/hora e IP solicitante.
informacoesDados da loteria, extração, tipo de busca e posição considerada.
dados.viciadosLista ordenada dos mais frequentes.
quantidadeTotal de vezes que o item apareceu no histórico analisado.
percentualPercentual de participação dentro do total de ocorrências analisadas.
ultima_saidaÚltima data em que o item apareceu, no formato dd/mm/YYYY.
Exemplo de resposta
{
    "usuario": {
        "terminal": "123456",
        "site_app": "Meu Site",
        "cliente_id": "987654"
    },
    "consulta": {
        "numero": 1,
        "data": "11/06/2026 15:45:04",
        "ip": "000.000.000.000"
    },
    "informacoes": {
        "tipo_api": "Viciados por Loteria",
        "loteria": "PT Rio de Janeiro",
        "sigla": "rj",
        "extracao": "21",
        "extracao_nome": "PTN Rio",
        "tipo_busca": "g",
        "tipo_nome": "Grupo",
        "posicao": "1-5",
        "posicoes_premio_consideradas": "1º ao 5º prêmio",
        "total_ocorrencias_analisadas": 8500,
        "total_registros": 25,
        "limite_retorno": 25,
        "data_referencia": "2026-06-11"
    },
    "dados": {
        "viciados": [
            {
                "grupo": "14",
                "animal": "Gato",
                "emoji": "🐈",
                "quadra": "53-54-55-56",
                "posicao": 1,
                "quantidade": 420,
                "percentual": 4.94000000000000039079850466805510222911834716796875,
                "ultima_saida": "28/05/2026",
                "ultima_saida_original": "2026-05-28"
            }
        ]
    }
}
09

Erros comuns

401 Token nao fornecido / Token invalido O Bearer Token está ausente, inválido ou o módulo está pausado.
403 Parâmetro inválido Loteria, extração, posição ou tipo de busca inválido.
400 JSON inválido O corpo enviado no POST JSON não pôde ser interpretado.
405 Método inválido A API aceita apenas GET ou POST.
10

Exemplos de uso

curl -X GET 'https://api.lotoserv.com/viciados/consulta/v1/?loteria=rj&tipo_busca=grupo&posicao=1-5&extracao=21' \
  -H 'Authorization: Bearer 25022FE61F971C203AE0ACBB'
curl -X POST 'https://api.lotoserv.com/viciados/consulta/v1/' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer 25022FE61F971C203AE0ACBB' \
  -d '{
    "loteria": "rj",
    "tipo_busca": "grupo",
    "posicao": "1-5",
    "extracao": "21"
  }'
<?php
$endpoint = 'https://api.lotoserv.com/viciados/consulta/v1/';
$token = '25022FE61F971C203AE0ACBB';

$params = [
	'loteria' => 'rj',
	'tipo_busca' => 'grupo',
	'posicao' => '1-5',
	'extracao' => '21'
];

$url = $endpoint . '?' . http_build_query($params);

$ch = curl_init($url);
curl_setopt_array($ch, [
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_HTTPGET => true,
	CURLOPT_HTTPHEADER => [
		'Authorization: Bearer ' . $token,
		'Accept: application/json'
	],
	CURLOPT_TIMEOUT => 30
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$erro = curl_error($ch);

curl_close($ch);

if($erro){
	die('Erro cURL: ' . $erro);
}

$dados = json_decode($response, true);

if($httpCode != 200){
	echo 'Erro na consulta: ';
	print_r($dados);
	exit;
}

print_r($dados['dados']['viciados']);
const axios = require('axios');

const endpoint = 'https://api.lotoserv.com/viciados/consulta/v1/';
const token = '25022FE61F971C203AE0ACBB';

async function consultarViciados() {
	try {
		const response = await axios.get(endpoint, {
			headers: {
				Authorization: `Bearer ${token}`,
				Accept: 'application/json'
			},
			params: {
				loteria: 'rj',
				tipo_busca: 'grupo',
				posicao: '1-5',
				extracao: '21'
			}
		});

		console.log(response.data.dados.viciados);
	} catch (error) {
		console.error(error.response?.data || error.message);
	}
}

consultarViciados();
import requests

endpoint = 'https://api.lotoserv.com/viciados/consulta/v1/'
token = '25022FE61F971C203AE0ACBB'

params = {
    'loteria': 'rj',
    'tipo_busca': 'grupo',
    'posicao': '1-5',
    'extracao': '21'
}

headers = {
    'Authorization': f'Bearer {token}',
    'Accept': 'application/json'
}

response = requests.get(endpoint, params=params, headers=headers, timeout=30)

print(response.status_code)
print(response.json())
11

Observações importantes

  • O campo loteria deve ser a sigla da loteria contratada no painel.
  • O cliente pode pausar loterias ou modalidades no painel. Consultas pausadas retornam erro.
  • O limite de requisições é controlado pelo plano contratado.
  • Para evitar respostas muito grandes, milhar e centena retornam até 1.000 registros.
  • O retorno é ordenado do mais frequente para o menos frequente.
  • Itens que nunca apareceram não entram no retorno da API de viciados.