---
title: "Catálogo do cash-in (o que entregamos ao receber PIX)"
method: GET
path: "/cashin/catalog"
tags: ["Cash-in"]
---

# Catálogo do cash-in (o que entregamos ao receber PIX)

`GET /cashin/catalog`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/cashin/catalog`
- Auth: API key in header `X-API-Key`

Catálogo de entrega cripto, usado em cash-in direto e saque da custódia. Ofereça apenas itens entregavel=true de instant/convert; instant pode estar vazio. Leia memoRequired, withdrawFee, withdrawMin e estimativas por rota. O mínimo em BRL depende da cotação em POST /cashin/preview. No saque da custódia exclua Liquid/DePix. stale=true indica catálogo em cache.

## Response `200`

Catálogo de compra.

- CatalogoCompra: Catálogo do cash-in (compra): o que entregamos ao receber um PIX.
  - `updatedAt` string, date-time, nullable
  - `instant` object[]: Rotas do trilho da casa; pode vir vazio conforme configuração. Não presuma presença ou prazo fixo.
    - `asset` string
    - `network` string
    - `eta` string
    - `entregavel` boolean
    - `min_brl_cents` integer: Menor cobranca em REAIS que esta rota entrega, ja com as taxas desta chave. E o mesmo numero de POST /cashin/preview (min_brl_cents) e o mesmo que aceita ou recusa a cobranca. Ausente quando ainda nao foi calculado para a rota; nesse caso leia a previa. Publicado desde 24/09/2026 para USDT e USDC.
  - `convert` object[]: Via corretora: uma linha por (ativo, rede).
    - `asset` string
    - `network` string
    - `etaSeconds` integer
    - `eta` string
    - `fastest` boolean
    - `withdrawFee` string: Taxa de retirada da corretora nesta rede, em unidades do ativo. Distinta das taxas da Lunium e do parceiro; já participa de minBuyAmount.
    - `withdrawMin` string: Mínimo de retirada da corretora nesta rede, em unidades do ativo. Não é o mínimo de depósito cripto do cash-out.
    - `withdrawMax` string: Teto de retirada publicado para a rede, em unidades do ativo. Não substitui o teto em BRL por operação, limites do pagador, saldo ou mandate. Ausência não significa ilimitado.
    - `minBuyAmount` string: Quantidade mínima A COMPRAR, em unidades do ativo, para cobrir withdrawMin + withdrawFee na rota de corretora. Não é necessariamente o valor líquido entregue. Consulte min_brl_cents em POST /cashin/preview com a própria chave; taxas e câmbio alteram o piso em reais.
    - `precision` integer
    - `memoRequired` boolean: Rede coletiva: payout_tag obrigatório.
    - `entregavel` boolean
    - `min_brl_cents` integer: Menor cobranca em REAIS que esta rota entrega, ja com as taxas desta chave. E o mesmo numero de POST /cashin/preview (min_brl_cents) e o mesmo que aceita ou recusa a cobranca. Ausente quando ainda nao foi calculado para a rota; nesse caso leia a previa. Publicado desde 24/09/2026 para USDT e USDC.
  - `dropped` object[]: Pares fora, com motivo (ex.: sem_par_usdt).
    - `asset` string
    - `network` string
    - `motivo` string
  - `totals` object
  - `stale` boolean: true se catálogo foi servido do cache de contingência.

## Other responses

- `401`: X-API-Key ausente, desconhecida ou incorreta.

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)