# Percorrer a lista inteira com o cursor > 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. Endereço: https://leiloes.wortic.com/guias/percorrer-com-cursor Fontes dos dados: Receita Federal, PNCP, Caixa e Diário de Justiça Eletrônico Nacional, pela Wortic. Wortic Leilões (/) / Guias (/guias/) Percorrer a lista inteira com o cursor 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. A lista nunca devolve tudo de uma vez. O cursor é o jeito seguro de ir até o fim sem pular nem repetir lote. ## A resposta ``` {"total": 200, "limite": 50, "proximo": "50", "leiloes": [ ... ]} ``` Na última página, proximo vem null. ``` {"total": 200, "limite": 50, "proximo": null, "leiloes": [ ... ]} ``` ## O código ``` export async function* todos(busca) { let cursor; do { const q = new URLSearchParams({ ...busca, ...(cursor && { cursor }) }); const r = await fetch(`https://leiloes.wortic.com/v1/leiloes?${q}`); if (!r.ok) throw new Error(`HTTP ${r.status}`); const pagina = await r.json(); yield* pagina.leiloes; cursor = pagina.proximo; await new Promise((ok) => setTimeout(ok, 1100)); } while (cursor); } for await (const l of todos({ tipo: "receita", uf: "SP" })) console.log(l.id, l.descricao); ``` A pausa de pouco mais de 1 segundo deixa o laço abaixo de 60 pedidos por minuto, e ele nunca recebe 429. ## Perguntas e respostas O que é o campo total? Quantos lotes a busca acha ao todo, para você mostrar o número ou uma barra de progresso. Posso pedir mais de 50 por página? Sem chave, o teto é 50. Com a chave do plano Pro, o limite vai até 1.000 por página, e dá para pedir a resposta em CSV ou jsonW. Percorrer a base inteira conta para o limite? Sim. Cada página é um pedido; sem chave, fique abaixo de 60 por minuto. Para volume, use a chave do plano Pro. Todos os guias (/guias/) · Documentação com exemplos (/docs) · openapi.json (/openapi.json) · Versão para IA (/llms.txt)