Wortic

Documentação da API de leilões

Leilões públicos do Brasil em JSON. Copie o exemplo da sua linguagem e rode: não precisa de cadastro nem de chave.

Publicado em . Fontes oficiais: o Sistema de Leilão Eletrônico da Receita Federal e o Portal Nacional de Contratações Públicas.

Comece em um minuto

O exemplo traz os celulares em leilão da Receita Federal no Rio Grande do Sul e mostra o lance mínimo e o link do edital de cada um.

curl "https://leiloes.wortic.com/v1/leiloes?tipo=receita&uf=RS&q=celular&limite=5"

Sem chave: 60 pedidos por minuto por IP. Ao receber 429, espere os segundos do cabeçalho retry-after.

No seu framework

A mesma consulta, escrita do jeito de cada pilha. TypeScript, Dart, Objective-C e COBOL rodaram contra esta API antes de entrar aqui; o TypeScript passou no compilador em modo estrito; o hook de React passou nos tipos oficiais do React 19; Laravel e WordPress tiveram a sintaxe conferida; Next.js, Vue, Svelte, Angular, Solid, Astro e Remix chamam a mesma função do TypeScript.

TypeScript (navegador, Node, Deno, Bun, borda)
// leiloes.ts: a consulta tipada, igual no navegador, no Node, no Deno, no Bun, no React Native e na borda.
export interface Leilao {
  id: string;
  fonte: string;
  categoria: string | null;
  uf: string | null;
  cidade: string | null;
  orgao: string | null;
  descricao: string | null;
  lance_minimo: number | null;
  avaliacao: number | null;
  abertura: string | null;
  encerramento: string | null;
  aberto: boolean;
  link: string | null;
  edital: string | null;
}

export interface Lista {
  total: number;
  limite: number;
  proximo: string | null;
  leiloes: Leilao[];
}

export interface Filtro {
  tipo?: string;
  uf?: string;
  q?: string;
  limite?: number;
  cursor?: string;
}

export class LimiteAtingido extends Error {
  readonly esperarSegundos: number;

  constructor(esperarSegundos: number) {
    super(`limite da API: tente de novo em ${esperarSegundos} s`);
    this.esperarSegundos = esperarSegundos;
  }
}

export async function buscarLeiloes(filtro: Filtro, sinal?: AbortSignal): Promise<Lista> {
  const params = new URLSearchParams(
    Object.entries(filtro).flatMap(([k, v]) => (v === undefined ? [] : [[k, String(v)]])),
  );
  const r = await fetch(`https://leiloes.wortic.com/v1/leiloes?${params}`, { signal: sinal ?? null });
  if (r.status === 429) throw new LimiteAtingido(Number(r.headers.get("retry-after") ?? 60));
  if (!r.ok) throw new Error(`leilões: HTTP ${r.status}`);
  return r.json() as Promise<Lista>;
}
React e React Native
// useLeiloes.ts: React e React Native. A consulta é cancelada se o filtro mudar ou o componente sair da tela.
import { useEffect, useState } from "react";
import { buscarLeiloes, type Filtro, type Lista } from "./leiloes.ts";

type Estado = { lista?: Lista; erro?: Error; carregando: boolean };

export function useLeiloes(filtro: Filtro): Estado {
  const [estado, setEstado] = useState<Estado>({ carregando: true });
  const chave = JSON.stringify(filtro);

  useEffect(() => {
    const controle = new AbortController();
    setEstado({ carregando: true });
    buscarLeiloes(JSON.parse(chave) as Filtro, controle.signal)
      .then((lista) => setEstado({ lista, carregando: false }))
      .catch((erro: unknown) => {
        if (!controle.signal.aborted) setEstado({ erro: erro as Error, carregando: false });
      });
    return () => controle.abort();
  }, [chave]);

  return estado;
}
Next.js (Route Handler)
// app/api/leiloes/route.ts (Next.js App Router): repassa o filtro da URL e guarda a resposta por uma hora no cache do Next.
import { buscarLeiloes, LimiteAtingido } from "./leiloes.ts";

export async function GET(pedido: Request): Promise<Response> {
  const p = new URL(pedido.url).searchParams;
  try {
    const lista = await buscarLeiloes({
      tipo: p.get("tipo") ?? undefined,
      uf: p.get("uf") ?? undefined,
      q: p.get("q") ?? undefined,
      cursor: p.get("cursor") ?? undefined,
    });
    return Response.json(lista, { headers: { "cache-control": "s-maxage=3600" } });
  } catch (e) {
    if (e instanceof LimiteAtingido) return new Response(null, { status: 429, headers: { "retry-after": String(e.esperarSegundos) } });
    return Response.json({ erro: (e as Error).message }, { status: 502 });
  }
}
Vue, Svelte, Angular, Solid, Astro e Remix
// Todos chamam a mesma buscarLeiloes de leiloes.ts, no lugar onde cada framework carrega dados.

// Vue 3 (<script setup lang="ts">)
const lista = ref<Lista>();
onMounted(async () => (lista.value = await buscarLeiloes({ tipo: "receita", uf: props.uf })));

// SvelteKit (src/routes/leiloes/[uf]/+page.ts)
export const load = async ({ params }) => ({ lista: await buscarLeiloes({ uf: params.uf }) });

// Angular (componente)
lista = signal<Lista | undefined>(undefined);
async ngOnInit() { this.lista.set(await buscarLeiloes({ uf: this.uf })); }

// SolidJS
const [lista] = createResource(() => ({ uf: props.uf }), buscarLeiloes);

// Astro (frontmatter da página)
const lista = await buscarLeiloes({ uf: Astro.params.uf! });

// Remix / React Router 7 (loader da rota)
export const loader = ({ params }: LoaderFunctionArgs) => buscarLeiloes({ uf: params.uf! });
Flutter e Dart
// leiloes.dart: Dart e Flutter, só com a biblioteca padrão (dart:io e dart:convert).
import 'dart:convert';
import 'dart:io';

typedef Lista = ({int total, List<Map<String, Object?>> leiloes});

Future<Lista> buscarLeiloes(Map<String, String> filtro) async {
  final cliente = HttpClient();
  try {
    final pedido = await cliente.getUrl(Uri.https('leiloes.wortic.com', '/v1/leiloes', filtro));
    final resposta = await pedido.close();
    if (resposta.statusCode == 429) throw HttpException('limite: espere ${resposta.headers.value('retry-after')} s');
    if (resposta.statusCode != 200) throw HttpException('leilões: HTTP ${resposta.statusCode}');
    final l = jsonDecode(await resposta.transform(utf8.decoder).join()) as Map<String, Object?>;
    return (total: l['total']! as int, leiloes: (l['leiloes']! as List).cast<Map<String, Object?>>());
  } finally {
    cliente.close();
  }
}

Future<void> main() async {
  final l = await buscarLeiloes({'tipo': 'receita', 'uf': 'RS', 'q': 'celular', 'limite': '2'});
  print('Dart: ${l.total} leilões; 1º: ${l.leiloes.first['cidade']} - ${l.leiloes.first['lance_minimo']}');
}
Laravel
<?php
// Laravel 12+: o cliente HTTP do framework, com nova tentativa no limite e cache de uma hora.
declare(strict_types=1);

use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Http;

function buscarLeiloes(array $filtro): array
{
    return Cache::remember('leiloes:' . md5(http_build_query($filtro)), now()->addHour(), static fn (): array => Http::baseUrl('https://leiloes.wortic.com')
        ->retry(3, static fn (int $tentativa, Exception $e): int => (int) ($e->response?->header('Retry-After') ?: 1) * 1000)
        ->get('/v1/leiloes', $filtro)
        ->throw()
        ->json());
}
WordPress
<?php
// WordPress: a API HTTP do próprio WordPress, com a resposta guardada num transient por uma hora.
declare(strict_types=1);

function wortic_buscar_leiloes(array $filtro): array|WP_Error
{
    $chave = 'wortic_leiloes_' . md5(http_build_query($filtro));
    $guardado = get_transient($chave);
    if (is_array($guardado)) {
        return $guardado;
    }

    $resposta = wp_remote_get(add_query_arg($filtro, 'https://leiloes.wortic.com/v1/leiloes'), ['timeout' => 10]);
    if (is_wp_error($resposta)) {
        return $resposta;
    }
    if (wp_remote_retrieve_response_code($resposta) !== 200) {
        return new WP_Error('leiloes', 'HTTP ' . wp_remote_retrieve_response_code($resposta));
    }

    $lista = json_decode(wp_remote_retrieve_body($resposta), true, 512, JSON_THROW_ON_ERROR);
    set_transient($chave, $lista, HOUR_IN_SECONDS);
    return $lista;
}
iOS e macOS (Objective-C)
// leiloes.m: iOS e macOS em Objective-C, com NSURLSession. clang -fobjc-arc leiloes.m -framework Foundation -o leiloes
#import <Foundation/Foundation.h>

static void buscarLeiloes(NSDictionary<NSString *, NSString *> *filtro, void (^pronto)(NSDictionary *_Nullable lista, NSError *_Nullable erro)) {
    NSURLComponents *u = [NSURLComponents componentsWithString:@"https://leiloes.wortic.com/v1/leiloes"];
    NSMutableArray<NSURLQueryItem *> *itens = [NSMutableArray array];
    for (NSString *k in filtro) [itens addObject:[NSURLQueryItem queryItemWithName:k value:filtro[k]]];
    u.queryItems = itens;
    [[NSURLSession.sharedSession dataTaskWithURL:u.URL
                               completionHandler:^(NSData *dados, NSURLResponse *resposta, NSError *erro) {
                                   NSInteger status = ((NSHTTPURLResponse *)resposta).statusCode;
                                   if (erro) {
                                       pronto(nil, erro);
                                   } else if (status != 200) {
                                       pronto(nil, [NSError errorWithDomain:@"leiloes.wortic.com" code:status userInfo:nil]);
                                   } else {
                                       pronto([NSJSONSerialization JSONObjectWithData:dados options:0 error:&erro], erro);
                                   }
                               }] resume];
}

int main(void) {
    @autoreleasepool {
        dispatch_semaphore_t fim = dispatch_semaphore_create(0);
        buscarLeiloes(@{@"tipo": @"receita", @"uf": @"RS", @"q": @"celular", @"limite": @"2"}, ^(NSDictionary *l, NSError *erro) {
            if (erro) NSLog(@"%@", erro);
            else printf("Objective-C: %ld leilões; 1º: %s\n", (long)[l[@"total"] integerValue], [l[@"leiloes"][0][@"cidade"] UTF8String]);
            dispatch_semaphore_signal(fim);
        });
        dispatch_semaphore_wait(fim, DISPATCH_TIME_FOREVER);
    }
}
COBOL
      >>SOURCE FORMAT FREE
*> leiloes.cob: COBOL (GnuCOBOL 3.2+). Busca os leilões de uma UF pelo curl do sistema e tira o total com UNSTRING.
*>   cobc -x -free leiloes.cob -o leiloes && ./leiloes RS
IDENTIFICATION DIVISION.
PROGRAM-ID. LEILOES.

ENVIRONMENT DIVISION.
INPUT-OUTPUT SECTION.
FILE-CONTROL.
    SELECT RESPOSTA ASSIGN TO "leiloes-resposta.txt" ORGANIZATION LINE SEQUENTIAL.

DATA DIVISION.
FILE SECTION.
FD RESPOSTA.
01 LINHA          PIC X(65535).

WORKING-STORAGE SECTION.
01 UF             PIC X(2).
01 COMANDO        PIC X(200).
01 ANTES          PIC X(65535).
01 RESTO          PIC X(65535).
01 TOTAL          PIC X(12).

PROCEDURE DIVISION.
    ACCEPT UF FROM ARGUMENT-VALUE
    STRING "curl -s 'https://leiloes.wortic.com/v1/leiloes?limite=1&uf=" FUNCTION TRIM(UF) "' -o leiloes-resposta.txt"
        DELIMITED BY SIZE INTO COMANDO
    CALL "SYSTEM" USING COMANDO

    OPEN INPUT RESPOSTA
    READ RESPOSTA
    CLOSE RESPOSTA

    UNSTRING LINHA DELIMITED BY '"total":' INTO ANTES RESTO
    UNSTRING RESTO DELIMITED BY ',' INTO TOTAL
    DISPLAY "COBOL: " FUNCTION TRIM(TOTAL) " leilões em " UF
    STOP RUN.

Os endereços

EndereçoO que devolve
GET /v1/leiloesA lista, abertos primeiro, pela data de encerramento. Com q, pela relevância.
GET /v1/leiloes/{id}A ficha de um leilão. Use o campo url que vem na lista: o id do PNCP tem / e # e precisa ir codificado.
GET /v1/leiloes/{id}/parecidosOs 10 lotes de descrição mais parecida.
GET /v1/tiposAs fontes, com quantos lotes, quantos abertos e a data da última leitura de cada uma.

Filtros da lista, sem chave

ParâmetroValor
tiporeceita, pncp, spu, aneel, caixa ou judicial
ufA sigla do estado, como SP
cidadeO nome da cidade; acento e maiúscula não importam
qPalavras do bem, como hilux 2019
ateEncerra até esta data, AAAA-MM-DD, horário de Brasília
cursorO valor de proximo da página anterior
limiteDe 1 a 50 (padrão 50)

No tipo judicial valem ate, cursor, limite e formato: as comunicações do Diário de Justiça não trazem valor, estado, cidade nem bem, e nunca trazem nome de parte, CPF ou número de processo.

Plano Pro

Com a chave do plano Pro no cabeçalho x-api-key, a lista ganha filtros, formatos e páginas maiores, e cada leilão do PNCP mostra os seus resultados.

ParâmetroValor
valor_min, valor_maxFaixa da avaliação, em reais: 150000 ou 150000.50
raiolatitude,longitude,km, até 500 km, pelo centro da cidade do lote
categoriaimovel, veiculo, joia, eletronico, informatica, celular, maquina, sucata, mobiliario, vestuario, embarcacao, aeronave, bebida, animal, outros; várias separadas por vírgula
encerra_emEncerra em até N dias, de 1 a 365
formatojson, csv (planilha) ou jsw (jsonW, o arquivo com esquema e conferência de integridade)
limiteAté 1.000 por página
curl -H "x-api-key: $CHAVE" "https://leiloes.wortic.com/v1/leiloes?categoria=imovel&raio=-30.03,-51.22,50&valor_max=500000&formato=csv"
curl -H "x-api-key: $CHAVE" https://leiloes.wortic.com/v1/leiloes/{id}/resultados

Os resultados mostram quem arrematou cada item e por quanto, só quando é empresa. A chave vai uma vez, no cabeçalho, nunca na URL; cabeçalho vazio, repetido ou fora do formato recebe 401 chave_invalida.

Erros e limite

RespostaQuando
400 com o nome do campoValor fora do formato; a mensagem diz o certo
401 chave_obrigatoriaFiltro ou rota do plano Pro sem chave
401 chave_invalidaChave vazia, repetida, fora do formato ou não reconhecida
404 nao_encontradoO id não está na base
429 limitePassou de 60 pedidos no minuto; espere o retry-after
429 bloqueadoPassou do limite 10 vezes: 1 hora; depois de 3 bloqueios de 1 hora, 6 horas
403 banidoDepois de 3 bloqueios de 6 horas

Conector MCP aberto, sem login

Para Claude, ChatGPT, Cursor e qualquer agente que fale MCP. Ferramentas: listar_leiloes e ver_lote, com o mesmo limite da API.

{"mcpServers": {"wortic-leiloes": {"url": "https://leiloes.wortic.com/mcp"}}}

Descrição completa em openapi.json (OpenAPI 3.1). Versão para IA em llms.txt.