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"
// Node 22+ (ESM) ou navegador
type Leilao = { id: string; url: string; descricao: string | null; lance_minimo: number | null; link: string | null };
type Lista = { total: number; proximo: string | null; leiloes: Leilao[] };
const base = "https://leiloes.wortic.com/v1/leiloes";
const resposta = await fetch(`${base}?${new URLSearchParams({ tipo: "receita", uf: "RS", q: "celular", limite: "5" })}`);
if (resposta.status === 429) throw new Error(`Limite: espere ${resposta.headers.get("retry-after")} s`);
const { total, leiloes } = (await resposta.json()) as Lista;
const reais = new Intl.NumberFormat("pt-BR", { style: "currency", currency: "BRL" });
console.log(`${total} leilões`);
for (const { descricao, lance_minimo, link } of leiloes) {
console.log(`${descricao?.slice(0, 60)} | ${lance_minimo == null ? "sem lance" : reais.format(lance_minimo)} | ${link}`);
}# Python 3.12+, só a biblioteca padrão
import json
from urllib.parse import urlencode
from urllib.request import urlopen
filtro = urlencode({"tipo": "receita", "uf": "RS", "q": "celular", "limite": 5})
with urlopen(f"https://leiloes.wortic.com/v1/leiloes?{filtro}") as resposta:
lista = json.load(resposta)
print(f"{lista['total']} leilões")
for leilao in lista["leiloes"]:
lance = leilao["lance_minimo"]
print(f"{(leilao['descricao'] or '')[:60]} | {'sem lance' if lance is None else f'R$ {lance:,.2f}'} | {leilao['link']}")<?php
// PHP 8.5
$filtro = http_build_query(['tipo' => 'receita', 'uf' => 'RS', 'q' => 'celular', 'limite' => 5]);
$lista = "https://leiloes.wortic.com/v1/leiloes?{$filtro}"
|> file_get_contents(...)
|> (fn (string $json) => json_decode($json, true, flags: JSON_THROW_ON_ERROR));
echo "{$lista['total']} leilões\n";
foreach ($lista['leiloes'] as ['descricao' => $descricao, 'lance_minimo' => $lance, 'link' => $link]) {
$valor = $lance === null ? 'sem lance' : 'R$ ' . number_format($lance, 2, ',', '.');
echo mb_substr($descricao ?? '', 0, 60), " | {$valor} | {$link}\n";
}// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde = { version = "1", features = ["derive"] }
use serde::Deserialize;
#[derive(Deserialize)]
struct Leilao { descricao: Option<String>, lance_minimo: Option<f64>, link: Option<String> }
#[derive(Deserialize)]
struct Lista { total: u64, leiloes: Vec<Leilao> }
fn main() -> Result<(), reqwest::Error> {
let lista: Lista = reqwest::blocking::Client::new()
.get("https://leiloes.wortic.com/v1/leiloes")
.query(&[("tipo", "receita"), ("uf", "RS"), ("q", "celular"), ("limite", "5")])
.send()?
.error_for_status()?
.json()?;
println!("{} leilões", lista.total);
for l in &lista.leiloes {
let lance = l.lance_minimo.map_or("sem lance".into(), |v| format!("R$ {v:.2}"));
let texto: String = l.descricao.as_deref().unwrap_or("").chars().take(60).collect();
println!("{texto} | {lance} | {}", l.link.as_deref().unwrap_or(""));
}
Ok(())
}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ço | O que devolve |
|---|---|
GET /v1/leiloes | A 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}/parecidos | Os 10 lotes de descrição mais parecida. |
GET /v1/tipos | As fontes, com quantos lotes, quantos abertos e a data da última leitura de cada uma. |
Filtros da lista, sem chave
| Parâmetro | Valor |
|---|---|
tipo | receita, pncp, spu, aneel, caixa ou judicial |
uf | A sigla do estado, como SP |
cidade | O nome da cidade; acento e maiúscula não importam |
q | Palavras do bem, como hilux 2019 |
ate | Encerra até esta data, AAAA-MM-DD, horário de Brasília |
cursor | O valor de proximo da página anterior |
limite | De 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âmetro | Valor |
|---|---|
valor_min, valor_max | Faixa da avaliação, em reais: 150000 ou 150000.50 |
raio | latitude,longitude,km, até 500 km, pelo centro da cidade do lote |
categoria | imovel, veiculo, joia, eletronico, informatica, celular, maquina, sucata, mobiliario, vestuario, embarcacao, aeronave, bebida, animal, outros; várias separadas por vírgula |
encerra_em | Encerra em até N dias, de 1 a 365 |
formato | json, csv (planilha) ou jsw (jsonW, o arquivo com esquema e conferência de integridade) |
limite | Até 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
| Resposta | Quando |
|---|---|
400 com o nome do campo | Valor fora do formato; a mensagem diz o certo |
401 chave_obrigatoria | Filtro ou rota do plano Pro sem chave |
401 chave_invalida | Chave vazia, repetida, fora do formato ou não reconhecida |
404 nao_encontrado | O id não está na base |
429 limite | Passou de 60 pedidos no minuto; espere o retry-after |
429 bloqueado | Passou do limite 10 vezes: 1 hora; depois de 3 bloqueios de 1 hora, 6 horas |
403 banido | Depois 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.