Mínimos y máximos por moneda, red y operación

Primero: ¿qué operación quieres realizar?

No existe un único “mínimo de USDT”. El importe depende de la dirección de la operación, de la red, de la ruta de conversión y de las condiciones de tu clave. Enviar USDT para recibir PIX y pagar PIX para recibir USDT son productos distintos.

En la compra y el retiro, consulta GET /cashin/catalog y envía la red en chain. En la venta, consulta GET /catalog y envía network. Una red puede estar disponible en una sola dirección. En esta guía, “depósito de cripto” significa la entrada de una venta que termina en PIX; no significa crear saldo de custodia en USDT.

Resumen de mínimos y máximos

Cómo combinar límites: el mínimo efectivo debe satisfacer todos los mínimos aplicables; el máximo efectivo debe ajustarse a todos los máximos aplicables. Convierte a la misma moneda antes de comparar. Si el mínimo supera el máximo disponible, no existe un importe válido para esa operación en ese momento.

Los valores de esta página son una instantánea de referencia. Las tarifas de la clave, la liquidez, el saldo disponible, el uso del pagador/destinatario y las políticas mandate pueden cambiar el resultado. La cotización y la creación vuelven a validar las condiciones. La ausencia de un campo o null no significa un valor cero ni una operación ilimitada.

Mínimo de la cuenta, de la red e importe entregado

Ejemplo didáctico: withdrawMin = "5" y withdrawFee = "0.0065" significan comprar al menos 5,0065 USDT para hacer posible un retiro de 5 USDT. Aún es necesario convertir ese coste a reales brasileños y aplicar las tarifas de la clave. La respuesta efectiva de la cotización determina el importe entregado.

Usa enteros para los centavos: 10000 representa R$ 100,00. Usa cadenas decimales para cripto: "6" representa 6 USDT cuando asset sea USDT. En brl_amount, "100.00" representa R$ 100,00; no envíes 10000 como si fueran centavos en ese campo. Respeta la precisión de la moneda, sin usar redondeo de coma flotante para las transferencias.

Cash-in: pagar BRL y recibir cripto

1. Consulta la clave en GET /keys/me: límites por operación, tarifas y eventual mandate.
2. Lee GET /cashin/catalog. Ofrece el par moneda/red solo cuando entregavel: true. Comprueba memoRequired.
3. Consulta GET /cashin/limits?payer_tax=CPF_OU_CNPJ hacia el documento de quien pagará.
4. Solicita POST /cashin/preview con importe, moneda y red. Usa min_brl_cents de la respuesta; cuando no esté presente, no inventes un mínimo en BRL a partir de otro activo.
5. Presenta el importe bruto en BRL, las tarifas y la cantidad neta estimada. Solo entonces crea la solicitud de cobro con los mismos parámetros de ruta.
6. Sigue la liquidación. Un PIX pagado no confirma la entrega de cripto: comprueba settlement_status y cashin.settled.

El límite por solicitud de cobro procede de limits.per_operation.cashin.max_brl_cents. El límite disponible del pagador puede ser menor. available_cents / instant_available_cents indican el rango sin retención; held_qr describe el rango con retención, cuando exista. max_amount_cents es orientativo y no exime de la validación de la clave, del proveedor ni de la ruta. Si el producto exige disponibilidad inmediata, gestiona explícitamente la retención con allow_hold: false y respeta la respuesta.

Límite en cripto: compara el importe neto que se retirará con withdrawMax, cuando esté publicado, y también con el límite en reales brasileños de la solicitud de cobro. No conviertas R$ 6.000 en una cantidad permanente de USDT: el tipo de cambio y las tarifas varían. El límite de red, el límite por operación y el límite del pagador son comprobaciones distintas.

USDT y USDC: valores de referencia por red

USDT

USDC

El mínimo en BRL de estas tablas procede de una vista previa con tarifa de integración cero. La tarifa de retiro de la red ya forma parte del mínimo; las tarifas de tu clave deben tenerse en cuenta en tu propia vista previa. La columna del máximo de la red no sustituye al máximo en BRL. Los plazos son estimaciones, no garantías de liquidación.

Cash-out: depositar cripto y recibir PIX

USDT/USDC en Polygon mediante la vía fast: el catálogo no publica un mínimo fijo de 6 tokens para esta ruta. El importe debe cumplir el mínimo en BRL de la operación. La cantidad mínima en USDT/USDC depende de la cotización; no conviertas “R$ 6” en “6 USDT”.

Vía convert: lee min y max de la propia moneda y confirma la red en networks. El intervalo de 6 a 200.000 unidades de las stablecoins no debe aplicarse a BTC, ETH ni a ninguna otra moneda. La tabla con buscador siguiente muestra los valores de cada activo del catálogo principal.

Después del límite de la moneda viene el límite en reales brasileños. La operación también debe respetar limits.per_operation.cashout, el remanente del límite diario del destinatario y el eventual mandate. Cuando la respuesta de la operación incluya limits, usa min_amount, max_amount, min_brl_cents y max_brl_cents según estén disponibles. No todos los rechazos incluyen estos campos.

Ejemplo: un máximo nominal de R$ 250.000 por operación y un máximo diario de R$ 100.000 por destinatario no autorizan un PIX de R$ 250.000. Si el destinatario ya consumió R$ 80.000 ese día, quedan como máximo R$ 20.000 de ese límite, antes de considerar otras restricciones. Dividir la venta en varias órdenes no elimina el límite diario. El límite diario se renueva a medianoche, hora de Brasilia, según la política publicada.

Flujo de depósito:

1. Consulta el catálogo y comprueba el par exacto. Si usas una vista previa, recuerda que no crea ni acepta una orden.
2. Crea la cotización en POST /cash-outs con amount o brl_amount, nunca ambos. Para indicar el PIX deseado en reales brasileños, usa brl_amount.
3. Comprueba la cantidad de cripto, el importe del PIX, las tarifas, la validez y los límites devueltos.
4. Acepta la cotización en la ruta /cash-outs/{cashout_id}/accept.
5. Usa exclusivamente deposit_address y el eventual deposit_tag devueltos al aceptar, en la red indicada. Transfiere la cantidad solicitada; ten en cuenta que el exchange de origen puede descontar su propia tarifa de envío.
6. Confirma COMPLETED para completar el PIX. La confirmación on-chain, el depósito acreditado y el PIX pagado son etapas distintas.

refund_address es opcional: si ya tienes la billetera del cliente en la red de la venta, puedes enviarla; sin ella, la billetera solo se solicita si falla la venta. No envíes cripto antes de obtener la dirección y la aceptación de la orden. Si vence el plazo o cambia el importe, obtén las nuevas instrucciones de la API; no reutilices una cotización antigua suponiendo el mismo tipo de cambio.

Consulta de todas las monedas y redes del catálogo principal

Esta instantánea enumera 1645 rutas de compra (1438 activos, incluidas las filas no disponibles) y 1531 pares de venta (1338 activos, sumando las vías fast y convert).

Busca, por ejemplo, USDT, BTC, ETH, polygon o tron y selecciona la dirección. Cada fila identifica la unidad del mínimo y del máximo. “Consultar vista previa” o “no publicado” significan que esa fuente no ofrece una cifra suficiente para prometer el límite.

Primeras 30 rutas de compra; activa JavaScript para buscar.

¹ Compra: cantidad mínima que comprar; venta: mínimo del activo/ruta. ² Compra: máximo de retiro de la red; venta: máximo del activo/ruta. ³ Máximo nominal en BRL, aún sujeto al pagador/destinatario, tarifas, saldo y política de la clave.

En la compra, las filas entregavel: false se identifican como no disponibles y no deben ofrecerse al cliente. En la venta mediante exchange, el catálogo publica un intervalo por activo y una lista de redes; la tabla repite ese intervalo en cada red permitida, sin inventar un límite específico por red. El mínimo en BRL de las demás monedas debe obtenerse en la vista previa de ese par, no en la cotización de USDT.

Tokens DEX: el catálogo principal indica las redes DEX, pero no enumera todos los tokens y sus límites. Consulta GET /catalog/dex?chain=...&q=..., identifica el token por dirección/token_address y obtén la cotización. La disponibilidad, el mínimo y el máximo dependen de la liquidez y de las restricciones de la operación. No reutilices los límites de las stablecoins ni identifiques un token solo por su símbolo. Esta tabla cubre todos los activos enumerados en los catálogos principales, no promete listar toda la lista de permitidos DEX.

Custodia: depósito en BRL y retiro en cripto

Entrada a saldo: destino: "saldo" acredita custodia en BRL. Sin entrega inmediata de cripto, el mínimo de retiro de USDT/Polygon no es el mínimo de entrada en custodia. Siguen aplicándose el mínimo de la cuenta/proveedor, el máximo de la solicitud de cobro y las condiciones del pagador. Las tarifas de depósito y las retenciones pueden reducir el saldo disponible.

Salida a cripto: selecciona una ruta entregable del catálogo de compra. El mínimo y el máximo de retiro de la red siguen siendo relevantes, pero la operación tiene su propia validación de importe y tarifas de retiro. La vista previa de cash-in no representa por sí sola el coste total del retiro de custodia. Consulta las condiciones en GET /saldo y la respuesta del retiro.

• amount_cents es el importe en BRL que se convertirá, no la cantidad de tokens.
• El saldo disponible debe cubrir el importe y las tarifas debitadas. No uses el saldo total retenido como saldo disponible.
• El período de espera, la retención y la falta de saldo son restricciones distintas del mínimo de la red.
• Liquid/DePix no es compatible con POST /saldo/sacar-cripto, aunque aparezca en el catálogo de compra. Para retirar reales brasileños mediante PIX, usa el flujo de POST /payouts.
• Si hay una subcuenta, usa el customer_ref correspondiente; no confundas el saldo de la cuenta principal con el de un cliente.

DePix: reglas propias de la ruta Liquid

DePix representa BRL en la red Liquid: 1 DePix corresponde nominalmente a R$ 1,00. Esto no hace que el importe bruto sea igual al neto tras las tarifas. En la compra, delivery_mode y las condiciones de la clave distinguen entre entrega directa (full) y entrega neta tras las tarifas (split). Usa la vista previa de esa ruta; la calculadora de tarifas para rutas de exchange que aparece a continuación excluye DePix.

En la venta, los límites y tarifas propios de la fila DEPIX/liquid prevalecen sobre el resumen de cash-out de otras criptomonedas. La creación exige payee_tax_number cuando la clave Pix no es CPF/CNPJ; refund_address (billetera Liquid del cliente) es opcional desde la API 1.44.0: sin ella, la billetera solo se solicita si falla la venta. La disponibilidad en el catálogo puede cambiar según el estado de la ruta.

Ejemplos de cálculo y rechazo

BRL → USDT en Polygon

Ejemplo didáctico, sin fijar la cotización de producción: mínimo de retiro 5 USDT, tarifa de red 0,0065 USDT, tipo de cambio R$ 5,30/USDT, tarifa fija R$ 2 y tarifa porcentual total 2%.

Quantidade mínima a comprar = 5 + 0,0065 = 5,0065 USDT
Custo da rota em BRL = 5,0065 × 5,30 = R$ 26,53445
Estimativa bruta = (26,53445 + 2) ÷ (1 − 0,02)
                 ≈ R$ 29,1168
Estimativa arredondada para cima em R$ 0,10: R$ 29,20

Este cálculo ayuda a entender el mínimo; min_brl_cents de la vista previa es la referencia para la operación. Los redondeos, la cotización efectiva y las tarifas de la clave pueden cambiar la cifra. No descuentes dos veces la tarifa de red: ya se sumó a la cantidad mínima que comprar.

¿Por qué R$ 10 puede aceptarse en USDC y rechazarse en USDT?

Las redes tienen mínimos distintos para cada moneda. En el ejemplo de Polygon, comprar 1,011 USDC puede permitir el retiro mínimo de USDC, mientras que USDT exige comprar 5,0065 USDT. Con el mismo tipo de cambio de referencia, el segundo requiere más reales brasileños. La aprobación de R$ 10 en USDC aún depende de las tarifas y los límites de la clave; no es una garantía universal.

¿Por qué el catálogo muestra 200.000 USDT y la venta rechaza un importe menor?

Porque ese es el máximo del activo en la ruta de conversión. El máximo en BRL, la disponibilidad diaria del destinatario o la política de la clave pueden ser menores. Presenta el límite efectivo, no la cifra más alta encontrada en una de las fuentes.

¿Cuánto debo enviar para que el PIX llegue por un importe exacto?

Usa la cotización inversa con brl_amount. Lee la cantidad de cripto devuelta, comprueba la validez y acepta la orden. No hagas la conversión con una cotización externa suponiendo que incluye las tarifas del producto.

Calculadora ilustrativa para rutas de exchange

Indica la tarifa porcentual total aplicable, incluida la comisión adicional de compra cuando exista, y la tarifa fija en reales brasileños. Los valores iniciales son solo un ejemplo. Esta calculadora usa los mínimos de referencia de las stablecoins y redondea hacia arriba en R$ 0,10. No consulta tu clave, no aplica el límite del pagador ni crea una cotización.

No uses el cálculo de cash-in para DePix, cash-out ni retiros de custodia. Cada producto tiene sus propias condiciones. Si una estimación supera el máximo disponible de la operación, no ofrezcas ese importe; consulta otra ruta permitida o las condiciones actualizadas.

Dónde consultar cada regla en la API

limits.max_brl_cents_por_transacao, cuando se devuelve, es el máximo nominal de la operación. limits.max_brl_cents en una respuesta de límite puede reflejar un máximo efectivo menor. No presupongas que los campos de una respuesta de error también existen en /keys/me.

Consultas de lectura y vista previa

Ejecuta en tu servidor con la clave en una variable de entorno. Sustituye PAYER_TAX por el documento del pagador real. Estos ejemplos no crean solicitudes de cobro, direcciones de depósito ni retiros.

curl --fail-with-body -sS 'https://api.luniumpay.com/keys/me' \
  -H "X-API-Key: $LUNIUM_API_KEY"

curl --fail-with-body -sS 'https://api.luniumpay.com/cashin/catalog' \
  -H "X-API-Key: $LUNIUM_API_KEY"

curl --fail-with-body -sS --get 'https://api.luniumpay.com/cashin/limits' \
  --data-urlencode "payer_tax=$PAYER_TAX" \
  -H "X-API-Key: $LUNIUM_API_KEY"

curl --fail-with-body -sS '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"}'

curl --fail-with-body -sS 'https://api.luniumpay.com/catalog' \
  -H "X-API-Key: $LUNIUM_API_KEY"

No incluyas una clave de producción en el JavaScript público del navegador. La página de documentación usa únicamente la instantánea pública, que no publica credenciales ni límites individuales de clientes.

Cómo tratar los errores sin entrar en un bucle de reintentos

Decide la lógica según erro y acao, conforme al contrato; detail es texto para explicárselo al usuario. Conserva request_id para el diagnóstico. Si no hay un límite numérico en la respuesta, no extraigas un valor arbitrario del texto como regla permanente. El sandbox tiene condiciones sintéticas y no demuestra los límites de producción.

Actualización, precisión y fuentes

Recopilación completada: 15/10/2026 00:41:01 (UTC−3). Catálogo de compra: 15/10/2026 00:34:29 (UTC−3). Catálogo de venta: 15/10/2026 00:40:08 (UTC−3).

Cotización USDT usada solo como referencia: R$ 5,15. No es la cotización de todas las monedas.

La instantánea usa una selección explícita de campos de los catálogos autenticados. La rutina está programada para actualizarse cada hora. Si falla la recopilación, el último archivo válido conserva su fecha original. stale: true en el catálogo indica contingencia; un dato en caché no debe anunciarse como una cotización nueva.

Las tablas, los datos integrados y los archivos Markdown de cada generación usan la misma instantánea. La fecha visible identifica las cifras mostradas; actualizar la página carga la generación disponible. El catálogo autenticado y la respuesta de tu operación prevalecen sobre esta instantánea pública.

Fuentes: referencia de la API, OpenAPI, manual de integración, catálogo público, esta guía en Markdown y catálogo completo en Markdown.

Lista de comprobación de la integración

• Distinguir entre compra, venta, depósito en custodia y retiro de la custodia.
• Seleccionar el par moneda/red en el catálogo correcto; validar memo/tag cuando sea obligatorio.
• Mostrar el mínimo y el máximo con la unidad explícita: BRL, centavos o cantidad de tokens.
• Mostrar las tarifas, la cantidad neta estimada y si habrá retención antes de confirmar.
• Aplicar el mayor mínimo y el menor máximo compatibles, sin mezclar monedas.
• Volver a consultar la vista previa al cambiar el importe, la moneda, la red o las condiciones de la clave.
• Distinguir entre límite ausente, ruta no disponible y operación sin un importe válido.
• En la venta, depositar solo después de aceptar y con los datos devueltos.
• Conservar la idempotencia al repetir la misma operación; cambiar los parámetros requiere seguir las reglas de external_id de la ruta.
• Confirmar la entrega/acreditación/PIX mediante los estados finales y conciliar con los webhooks y consultas.