Mínimos e redes por operação

As três operações e o catálogo de cada uma

São três operações diferentes, com catálogos diferentes. Copiar a lista de uma para a outra é o engano mais comum: a rede em que conseguimos entregar cripto não é a mesma em que conseguimos receber cripto.

O nome do campo muda de propósito entre os produtos e é um erro frequente de integração: na compra e no saque a rede é chain; na venda é network.

São dois mínimos, não um

1. O mínimo da conta, em reais

Vem das taxas da sua chave e existe só para a taxa fixa não comer o valor inteiro. Está em GET /keys/me, no campo limits.per_operation.cashin.min_brl_cents. É um piso baixo — numa chave sem taxa fixa ele é R$ 1,00 — e quase nunca é ele que recusa.

2. O mínimo da rede, na moeda

Cada rede tem um mínimo de saque e uma taxa de saque próprios na corretora. Para entregar o mínimo da rede é preciso comprar mínimo + taxa. Esse número é o minBuyAmount de GET /cashin/catalog, na moeda, e é quase sempre ele que recusa. Ele muda sozinho quando a corretora mexe na taxa de saque.

Vale o maior dos dois. É por isso que uma cobrança de R$ 10,00 pode ser recusada mesmo com o /keys/me anunciando R$ 1,00: o piso que valeu foi o da rede.

Comprar: PIX → cripto

USDT e USDC estão habilitados. A tabela abaixo é o catálogo vivo, lido da própria API: o mínimo está na moeda, e a coluna em reais usa a cotação de referência de R$ 5,29 por USDT, sem nenhuma taxa. As taxas da sua chave entram por cima — a conta está na calculadora.

USDT

No catálogo essas redes aparecem com entregavel: false e não são oferecidas para USDT: aptos, near, polkadot. Elas existem na corretora, mas não sabemos conferir o endereço dessas famílias — e entregar em endereço que não sabemos validar é perder o dinheiro do cliente.

USDC

No catálogo essas redes aparecem com entregavel: false e não são oferecidas para USDC: aptos, arc, polkadot, stark, sui, xdc. Elas existem na corretora, mas não sabemos conferir o endereço dessas famílias — e entregar em endereço que não sabemos validar é perder o dinheiro do cliente.

DePix

DePix é entregue na rede liquid, da nossa carteira, a partir de R$ 1,01. 1 DePix = R$ 1,00.

O catálogo completo tem 1.662 rotas, com outras centenas de moedas. Ele vem de GET /cashin/catalog, com a sua chave.

Vender: cripto → PIX

Trilho rápido

USDT e USDC na Polygon saem pelo trilho rápido: o PIX é pago em segundos e não existe piso em cripto — vale só o mínimo por operação, de R$ 6,00. Foi por isso que ordens de 2 e de 5 USDT na Polygon foram aceitas normalmente.

Demais redes, pela corretora

Nas outras redes a cripto passa pela corretora e o catálogo impõe mínimo de 6 unidades e máximo de 200.000 unidades, por moeda. Abaixo disso a resposta é valor mínimo: 6 USDT — é a recusa mais comum de quem está testando com valor pequeno.

Em reais, a operação vai de R$ 6,00 a R$ 250.000,00. O prazo abaixo é o da corretora creditar o depósito do seu cliente; o PIX sai depois dele.

USDT

USDC

DePix

O DePix tambem vende, e por trilho proprio: o cliente manda DePix na rede liquid e o PIX sai em cerca de 1 minuto. De R$ 1.02 a R$ 6000.00 por ordem, taxa da Lunium de 1,5% + R$ 1,00. A criacao exige refund_address Liquid e, quando a chave PIX nao e CPF/CNPJ, payee_tax_number.

A lista que vale é o campo networks de GET /catalog. Redes que exigem memo ficam fora da venda mesmo quando aparecem na compra: um depósito sem memo em endereço compartilhado não tem dono.

Sacar a custódia em cripto

O saldo da custódia é em reais. No saque você escolhe moeda e rede, e vale o mesmo catálogo e os mesmos mínimos da compra — a tabela da seção 3 serve inteira aqui. Duas diferenças: o valor vai em amount_cents (reais a converter, não quantidade de cripto) e o saldo precisa cobrir valor + taxas, senão a resposta é 402 saldo_insuficiente.

Por que R$ 10,00 passa em USDC e é recusado em USDT

É a pergunta que mais chega, e a resposta não é a moeda: é a rede. Na Polygon, a corretora exige 5,0065 USDT de saque em USDT e só 1,011 USDC em USDC. Como o mínimo é comprado, não pedido, o mesmo valor em reais passa numa moeda e não passa na outra.

O mesmo vale ao contrário: uma rede barata hoje pode ficar cara amanhã, porque a taxa de saque é da corretora e muda sem aviso. Leia o catálogo antes de cotar, não uma vez na integração.

Onde a API devolve o mínimo

Nenhum número desta página precisa ser copiado para o seu código. Todos eles vêm da resposta da própria chamada:

curl -s https://api.luniumpay.com/cashin/preview \
  -H "X-API-Key: $LUNIUM_API_KEY" -H 'Content-Type: application/json' \
  -d '{"amount_cents":10000,"asset":"usdt","chain":"polygon"}'

{ "asset":"usdt", "chain":"polygon", "amount":"...", "network_min":"5",
  "withdraw_fee":"0.0065", "min_brl_cents":2650, "eta":"ate 2 min" }

O mínimo com as suas taxas

A tabela acima é o piso da rota, sem taxa nenhuma. Sobre ele entram a sua taxa percentual e a fixa, e também a sub fee do parceiro quando existe. A conta é (piso + taxa fixa) ÷ (1 − bps ÷ 10000). Informe as suas e veja o número que a sua chave vai recusar abaixo.

Número aproximado, para dimensionar a tela. O valor que a API aceita é sempre o min_brl_cents da prévia.

Acompanhamento humano e ao vivo

Grupo humano fortemente recomendado: a Lunium ou o parceiro pode criar o grupo do projeto e adicionar @luniumb2b e @luniumb2c, além de @LuniumNotifyBot. Veja o roteiro do grupo. Para acompanhamento, use o monitor privado de /keys/me e implemente webhooks, painel ao vivo e conciliação. Não compartilhe chaves, segredos ou o monitor com pessoas não autorizadas.