各币种、网络及交易的最低与最高金额

先明确：您要执行哪种交易？

USDT 并不存在适用于所有流程的统一最低金额。 金额取决于交易方向、网络、兑换路径及密钥条件。发送 USDT 接收 Pix，与支付 Pix 接收 USDT，是不同产品流程。

购买及提现时，查询 GET /cashin/catalog ，并在以下字段传入网络： chain。卖出时，查询 GET /catalog ，并传入 network。某网络可能只支持一个方向。本指南的“加密资产充值”指最终支付 Pix 的卖出入金，不表示创建 USDT 托管余额。

最低与最高金额概览

如何结合不同限额： 实际最低金额须满足所有适用下限，实际最高金额须不超过所有适用上限。比较前换算至同一币种。若最低金额超过当前最高可用额度，则此时不存在可执行金额。

本页数值仅为参考快照，密钥费用、流动性、可用余额、付款人 / 收款人已用额度及 mandate 等策略可能影响最终结果。报价及创建时会重新校验，字段缺失或 null 不代表零值或无限额。

账户最低金额、网络最低数量与交付净额

教学示例： withdrawMin = "5" 及 withdrawFee = "0.0065" 表示至少购买 5.0065 USDT ，才可完成以下提现： 5 USDT。仍须换算为 BRL 并计入密钥费用，最终交付数量以实际报价响应为准。

BRL 分使用整数： 10000 表示 R$ 100.00。加密资产使用十进制字符串： "6" 表示 6 USDT，前提是 asset 为 USDT。对于 brl_amount、 "100.00" ，表示 R$ 100.00，不要传入 10000 并误当成分。遵守资产精度，不使用浮点数舍入处理转账。

Cash-in：支付 BRL，接收加密资产

1. 通过以下接口读取密钥条件： GET /keys/me，包括单笔限额、费用及可能适用的 mandate。
2. 读取 GET /cashin/catalog。提供的币种 / 网络组合须符合 entregavel: true。核对 memoRequired。
3. 使用GET /cashin/limits?payer_tax=CPF_OU_CNPJ 查询，并填写实际支付 Pix 的付款人证件。
4. 请求 POST /cashin/preview ，传入金额、币种及网络。使用响应中的 min_brl_cents ；如缺失，不要根据另一资产编造最低 BRL 金额。
5. 展示 BRL 总额、费用及预估接收净数量，再用相同路由参数创建收款单。
6. 跟踪结算。Pix 已付款不代表加密资产已交付，须核对 settlement_status 及 cashin.settled。

每张收款单上限来自 limits.per_operation.cashin.max_brl_cents，付款人的剩余额度可能更低。 available_cents / instant_available_cents 表示无需冻结的额度区间； held_qr 表示需要冻结的区间，如适用。 max_amount_cents 仅供参考，不能替代密钥、服务商或路由校验。如产品要求资金立即可用，应通过以下参数明确处理冻结： allow_hold: false ，并遵守响应。

加密资产数量上限： 将待提取净数量与 withdrawMax比较（如提供），并同时核对收款单的 BRL 上限。不要将 R$ 6,000 固定换算为某个 USDT 数量，汇率及费用会变化。网络、单笔及付款人限额是不同校验。

USDT 与 USDC：各网络参考数值

USDT

USDC

表中最低 BRL 金额来自接入费率为零的预览，已考虑网络提现费用。您须通过自己的密钥预览计入适用费用。网络上限不能替代 BRL 上限，时效均为预估，不是结算保证。

Cash-out：充值加密资产，接收 Pix

Polygon 上的 USDT/USDC 通过 fast： 渠道时，不应套用固定 6 个代币的最低数量，须满足交易最低 BRL 金额。实际 USDT/USDC 数量取决于报价，不要把“R$ 6”当成“6 USDT”。

渠道 convert： 读取 min 及 max 中对应资产的数值，并通过 networks核对网络。稳定币的 6 至 200,000 单位区间不适用于 BTC、ETH 或其他资产，下方搜索表列出主目录各资产的独立数值。

资产数量限额之外，还须遵守 BRL 限额。 交易还须满足 limits.per_operation.cashout、收款人当日剩余额度及适用的 mandate。交易响应提供以下字段时，请读取： limits中，使用 min_amount、 max_amount、 min_brl_cents 及 max_brl_cents （如有）。并非每种拒绝响应都包含全部字段。

示例：单笔名义上限 R$ 250,000，加上收款人每日 R$ 100,000 限制，不代表可执行 R$ 250,000 的 Pix。若收款人当日已用 R$ 80,000，则该项剩余额度最多 R$ 20,000，还须考虑其他限制。拆分为多笔订单不能绕过每日上限。按公开规则，额度于巴西利亚时间午夜重置。

充值流程：

1. 查询目录并核对精确组合。预览既不创建订单，也不接受报价。
2. 通过以下接口创建报价： POST /cash-outs 并传入 amount 或 brl_amount，两者不可同时发送。按期望 Pix BRL 金额报价，使用 brl_amount。
3. 核对返回的加密资产数量、Pix 金额、费用、有效期及限额。
4. 通过以下接口接受报价： /cash-outs/{cashout_id}/accept。
5. 仅使用接受响应中的 deposit_address 及必要的 deposit_tag ，并选择指定网络。转入请求的精确数量，注意来源交易所可能扣除自身发送费用。
6. 确认达到 COMPLETED 后，才视为 Pix 已完成。链上确认、充值入账及 Pix 已支付是不同阶段。

refund_address 为可选项。已有客户退款网络钱包时可提前提供；未提供时，仅卖出失败后才要求填写。取得订单地址并接受报价前，不发送加密资产。期限已过或金额变化时，须取得 API 新说明，不假定旧报价汇率仍然有效。

查询主目录全部币种与网络

本快照列出 1,645 条购买路由 （1,438 种资产，含不可用项目）及 1,531 个卖出组合 （1,338 种资产，汇总以下渠道： fast 及 convert).

可搜索，例如 USDT、 BTC、 ETH、 polygon 或 tron ，再选择交易方向。每行明确最低及最高金额单位。“查询预览”或“未公布”表示此来源不足以给出具体限额。

先显示 30 条购买路由，启用 JavaScript 后可搜索全部。

¹ 购买：最低购买数量；卖出：资产 / 路由最低数量。² 购买：网络最高提现量；卖出：资产 / 路由最高数量。³ 名义 BRL 上限仍受付款人 / 收款人、费用、余额及密钥规则约束。

购买目录中， entregavel: false 会标为不可用，不应提供给客户。交易所卖出目录按资产提供一个区间及网络列表，表格将该区间列于各支持网络，不编造网络独立限额。其他币种的最低 BRL 金额须查询对应组合预览，不能套用 USDT 报价。

DEX 代币： 主目录提供 DEX 网络，但不列出全部代币及其限额。请查询 GET /catalog/dex?chain=...&q=...，按合约地址 /token_address 识别代币并报价。可用性、最低及最高金额取决于流动性及交易限制。不要套用稳定币限额，也不要仅按符号识别代币。本表覆盖主目录列出的资产，不保证包含全部 DEX 白名单。

资金托管：充值 BRL，以加密资产提现

充值至余额： destino: "saldo" 记入 BRL 托管余额，不立即交付加密资产，因此 USDT/Polygon 最低提现量不是托管入金下限。仍须满足账户 / 服务商最低金额、收款单上限及付款人规则，充值费用及冻结可能减少可用余额。

提现为加密资产： 选择购买目录中可交付的路由，网络最低及最高提现量仍适用，并有独立金额及提现费用校验。Cash-in 预览本身不代表托管提现的完整成本，须结合 GET /saldo 及提现响应。

• amount_cents 是待兑换 BRL 金额，不是代币数量。
• 余额中的 可用 须足以覆盖本金及费用，不要把包含冻结款项的总额当作可用余额。
• 等待期、资金冻结及余额不足，与网络最低金额是不同限制。
• Liquid/DePix 不支持 POST /saldo/sacar-cripto，即使出现在购买目录中也一样。通过 Pix 提取 BRL，请使用 POST /payouts。
• 如有子账户，请使用对应的 customer_ref ，不混淆主账户与客户子账户余额。

DePix：Liquid 路由独立规则

DePix 表示 Liquid 网络中的 BRL，名义上 1 DePix 对应 R$ 1.00，但扣费后净额不等于总额。购买时， delivery_mode 及密钥条件区分直接交付（full）与扣费后净额交付（split）。请使用该路由预览，下方交易所路由费用计算器不适用于 DePix。

卖出时，以下目录行的独立限额及费用： DEPIX/liquid 优先于其他加密资产 cash-out 概览。Pix 标识不是 CPF/CNPJ 时，创建须提供 payee_tax_number ； refund_address （客户 Liquid 钱包）自 API 1.44.0 起可选，未提供时仅在卖出失败后要求填写。目录可用性可能随路由健康状态变化。

计算与拒绝示例

BRL → Polygon 上的 USDT

教学示例，不代表生产汇率：最低提现量 5 USDT，网络费用 0.0065 USDT，汇率 R$ 5.30/USDT，固定费用 R$ 2 ，总比例费用 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

此计算仅帮助理解最低金额，交易参考应为 min_brl_cents 在预览中返回的数值。舍入、实际汇率及密钥费用可能改变结果。不要重复扣除网络费用，它已计入最低购买数量。

为何 R$ 10 可能支持 USDC，却不支持 USDT？

各币种网络的最低数量不同。例如 Polygon 上购买 1.011 USDC 可能满足其最低提现要求，而 USDT 须购买 5.0065 USDT。同一参考汇率下，后者需要更多 BRL。R$ 10 是否足够购买 USDC，还取决于密钥费用及限额，不是通用保证。

目录显示 200,000 USDT，为什么更小卖出仍被拒绝？

那是兑换渠道的资产数量上限，BRL 上限、收款人当日剩余额度或密钥策略可能更低。请展示 实际有效值，而不是不同来源中的最大数值。

须发送多少，才能让 Pix 收款金额准确？

通过反向报价，传入 brl_amount。读取返回的精确加密资产数量，核对有效期并接受订单，不要使用外部汇率换算后假定已包含产品费用。

交易所路由说明计算器

请填写适用的 总比例费用 ，包括适用购买佣金，并填写固定 BRL 费用。初始值仅为示例。此计算器使用稳定币参考最低金额，并按 R$ 0.10 向上取整，不查询您的密钥、不校验付款人额度，也不创建报价。

不要将 cash-in 计算套用于 DePix、cash-out 或托管提现，各产品有独立条件。若预估金额超过交易剩余额度，不应提供该金额，须查询其他允许路由或更新后的条件。

各规则的 API 查询来源

limits.max_brl_cents_por_transacao如有返回，表示单笔名义上限。 limits.max_brl_cents 在限额错误中可能表示更低的实际上限，不要假定错误响应的字段也一定存在于 /keys/me。

只读查询与预览

在服务器执行，密钥保存在环境变量中。将 PAYER_TAX 替换为实际付款人的证件。示例不创建收款单、充值地址或提现。

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"

不要在公开浏览器 JavaScript 中放入生产密钥。文档仅使用公开快照，不包含凭证或客户个别限额。

如何处理错误并避免循环重试

按以下字段编写业务分支： erro 及 acao，并遵守接口契约； detail 仅用于向用户说明。保存 request_id 用于诊断。响应无数值限额时，不从自由文本提取任意金额作为永久规则。测试环境为模拟条件，不证明生产限额。

更新、精度与资料来源

采集完成时间： 2026年10月15日 00:41:01（UTC-3）。 购买目录： 2026年10月15日 00:34:29（UTC-3）。 卖出目录： 2026年10月15日 00:40:08（UTC-3）。

USDT 参考汇率 R$ 5.15，仅用于说明，不是所有币种的汇率。

本中文版本为页面标注日期的审校快照。原始采集程序计划每小时刷新目录；采集失败时保留上一份有效文件及其日期。实际交易须使用当前 API 重新核验。 stale: true 在目录中表示备用缓存，不应将缓存数据称为新报价。

同一次生成的表格、内嵌数据及 Markdown 使用同一快照，显示日期对应所展示数值。刷新页面将加载当前已发布版本。已验证身份的目录及实际交易响应优先于公开快照。

资料来源： API 参考文档、 OpenAPI、 接入手册、 公开目录、 本指南 Markdown 版 及 完整目录 Markdown 版。

接入检查清单

• 区分购买、卖出、托管充值及托管提现。
• 在正确目录选择币种 / 网络，需要时校验 memo/tag。
• 最低及最高金额明确标注单位：BRL、分或代币数量。
• 确认前展示费用、预计净接收数量及冻结条件。
• 适用最低金额取最大值、最高金额取最小值，先统一币种再比较。
• 金额、币种、网络或密钥条件变化后重新查询预览。
• 区分限额未公布、路由不可用，以及当前无有效交易金额。
• 卖出仅在接受报价后，按返回资料充值。
• 同一交易重试保持幂等，更改参数须遵循该接口的 external_id 规则。
• 通过最终状态确认交付 / 入账 / Pix，并结合 webhook 及查询对账。