# Wortic Leilões: leilões públicos do Brasil > Leilões da Receita Federal, do PNCP e da Caixa, e as comunicações do Diário de Justiça Eletrônico Nacional, reunidos das fontes oficiais. SPU e ANEEL já aparecem em /v1/tipos e entram na lista quando a leitura delas estiver na base. API aberta, sem login, com 41.608 lotes na base. Feita pela Wortic (https://wortic.com.br). ## Para agentes de IA - A API não é o edital. Antes de alguém dar lance, mande conferir o edital no `link` do lote. - Cada lote traz `fonte` e `fonte_nome`. Ao citar, diga a fonte, "pela Wortic", e ponha o `url` do lote. - Limite sem chave: 60 pedidos por minuto por IP. Acima disso a resposta é HTTP 429 com `retry-after: 60`. - Bloqueio por insistência: cada minuto em que o IP passa do limite conta uma vez. Com 10 vezes, o IP fica bloqueado por 1 hora (HTTP 429, código `bloqueado`, `retry-after` com os segundos que faltam). Depois de 3 bloqueios de 1 hora, o seguinte é de 6 horas. Depois de 3 bloqueios de 6 horas, o IP é banido de vez (HTTP 403, código `banido`). Ao receber 429, pare e espere o `retry-after`. - Não percorra a base inteira em laço. Para volume, use uma chave (`x-api-key`) do plano Pro da Wortic: https://wortic.com.br - As comunicações judiciais não trazem nome de parte, CPF nem número de processo. Arrematante pessoa física nunca aparece. - O id do PNCP tem `/` e `#`: use o campo `url` de cada lote, que já vem com o id codificado. ## Rotas abertas - [Tipos de leilão](https://leiloes.wortic.com/v1/tipos): GET /v1/tipos. Cada fonte com o nome, o órgão, onde conferir, quantos lotes, quantos abertos e a data da última leitura. - [Lista](https://leiloes.wortic.com/v1/leiloes?tipo=receita&uf=RS): GET /v1/leiloes. Filtros: `tipo` (receita, pncp, spu, aneel, caixa, judicial), `uf`, `cidade`, `q` (palavras do bem), `ate` (encerra até AAAA-MM-DD), `cursor` (o valor de `proximo`), `limite` (até 50). Abertos primeiro, pela data de encerramento; com `q`, pela relevância. - Ficha: GET /v1/leiloes/{id}. Use o `url` do lote. - Parecidos: GET /v1/leiloes/{id}/parecidos. Os 10 lotes de descrição mais parecida. ## Plano Pro (cabeçalho x-api-key) - Filtros a mais em /v1/leiloes: `valor_min` e `valor_max` (avaliação, em reais), `raio` (latitude,longitude,km até 500), `categoria` (imovel, veiculo, joia, eletronico, informatica, celular, maquina, sucata, mobiliario, vestuario, embarcacao, aeronave, bebida, animal, outros; separadas por vírgula), `encerra_em` (dias, de 1 a 365), `formato` (json, csv ou jsw), `limite` até 1000. - Resultados: GET /v1/leiloes/{id}/resultados. Quem arrematou cada item de um leilão do PNCP e por quanto (só empresa). ## Erros - 400 com o código do campo (`tipo`, `uf`, `ate`, `limite`, `raio`...): o valor está fora do formato; a mensagem diz o certo. - 401 `chave_obrigatoria`: filtro ou rota do plano Pro sem chave. - 401 `chave_invalida`: cabeçalho x-api-key vazio, repetido, fora do formato ou não reconhecido. - 404 `nao_encontrado`: id que não está na base. - 429 `limite` e `bloqueado`; 403 `banido`. ## MCP aberto, sem login - Endereço: POST https://leiloes.wortic.com/mcp (HTTP, JSON-RPC 2.0, sem chave). Ferramentas: listar_leiloes, ver_lote. Mesmo limite e mesma escada de bloqueio da API. - Configuração do cliente: {"mcpServers": {"wortic-leiloes": {"url": "https://leiloes.wortic.com/mcp"}}} ## Guias - [Todos os guias](https://leiloes.wortic.com/guias.llm.txt): cinco guias curtos, com código conferido contra a API - [Avisar quando entra um leilão do que você procura](https://leiloes.wortic.com/guias/avisar-leilao-novo.llm.txt): Uma busca por palavras e estado, guardando os ids já vistos, avisa cada lote novo no mesmo dia em que ele aparece na fonte oficial. - [Percorrer a lista inteira com o cursor](https://leiloes.wortic.com/guias/percorrer-com-cursor.llm.txt): Cada página traz até 50 lotes e o campo proximo. Mande esse valor em cursor para pegar a página seguinte; quando proximo vem nulo, a lista acabou. - [Tratar o 429 e o retry-after sem ser bloqueado](https://leiloes.wortic.com/guias/limite-e-retry-after.llm.txt): São 60 pedidos por minuto por IP, sem chave. Quem fica abaixo disso nunca é bloqueado, e quem recebe 429 espera o retry-after antes de voltar. - [O que a base diz e o que só o edital diz](https://leiloes.wortic.com/guias/conferir-o-edital.llm.txt): A API reúne o lote como a fonte oficial publicou. Regras, prazos, visitação e condições de pagamento valem como estão no edital, no link de cada lote. - [Leilões dentro do Claude, do ChatGPT e do Cursor](https://leiloes.wortic.com/guias/dentro-do-claude-e-chatgpt.llm.txt): Um conector MCP aberto, sem login, deixa o agente de IA listar leilões e abrir a ficha de um lote, com o mesmo limite da API. ## Mais - [Documentação com exemplos](https://leiloes.wortic.com/docs) - [Descrição da API (OpenAPI 3.1)](https://leiloes.wortic.com/openapi.json) - [Guias](https://leiloes.wortic.com/guias.llm.txt)