Lumx stablecoins and wallets FAQ
Which stablecoins and networks Lumx supports, who holds the keys, how deposits, transfers and conversion work, and how addresses are screened.
Which stablecoins and networks does Lumx support?
Lumx supports USDC and USDT on five blockchains. Ethereum and Polygon carry both USDC and USDT, Base carries USDC, Tron carries USDT, and Stellar carries USDC for on-ramps only. Lumx converts these stablecoins to and from BRL, USD, EUR, MXN and GBP, except Stellar, which converts from BRL only. EURC is not part of the list.
Does each customer get their own wallet?
Yes. Every Lumx customer gets a wallet on each supported blockchain, created at the same time as the customer. The wallet only becomes usable once the customer reaches APPROVED after verification. One wallet is marked as default, and Lumx uses it whenever a request does not name a blockchain.
How do I deposit stablecoins from an external wallet?
Send a supported stablecoin to the customer's wallet address on the matching network. Each wallet address is a real on-chain address, so anyone can send to it, and no on-ramp is needed. The deposit shows in the wallet within seconds of confirmation on the network. Send only the stablecoins listed for that blockchain, since a deposit on an unsupported network or token may not be recoverable.
How do I send stablecoins out of a Lumx wallet?
Use the Transfer endpoint. It moves stablecoin from a customer's wallet to another Lumx customer or to any external wallet address, such as a self-custody wallet, an exchange or a counterparty. A transfer has no conversion and runs one step, TRANSFERRING_STABLECOIN, then SUCCESS. Lumx covers the network fee on its legs, so the customer does not need ETH or TRX.
How do I check a wallet balance?
Read the customer through the API. The response lists each wallet with its blockchain, address, a block explorer link and the balances, where every entry shows the currency (USDC or USDT), the amount and when it was last updated. To keep balances in sync inside your product, subscribe to the onramp.success, offramp.success and transfer.success webhooks.
How does Lumx convert between stablecoins and fiat?
Through on-ramps and off-ramps. An on-ramp turns fiat into stablecoin in the customer's wallet, and an off-ramp turns stablecoin into fiat sent to a registered destination. Lumx operates the conversion, and the local payment leg runs through the banking partner. You can request a floating rate or lock one for 30 seconds, 1 minute or 5 minutes. An autoconversion rule can convert every fiat deposit automatically.
Where does Lumx get its conversion liquidity?
From its own liquidity and from institutional counterparties only, BTG Pactual among them. Lumx sources USDC liquidity this way and also holds its own mint account at Circle. BTG Pactual is Lumx's strategic partner and investor and one of those counterparties. It does not guarantee customer balances, and Lumx does not take liquidity from just anyone.
How does Lumx screen incoming and outgoing wallet addresses?
Lumx screens every transaction before it runs, incoming and outgoing. On-chain activity is monitored with Chainalysis KYT, which covers every kind of wallet, including external senders and recipients. Fiat legs use Lumx's own monitoring plus oversight from the banking partners. Lumx also says it is aligned with the Travel Rule, and every on-ramp and off-ramp carries a purpose code.
What happens if Tether or Circle freezes an address?
Lumx has a process for a customer's custodial address frozen by Tether or Circle. Screening reads the issuers' blocklists, and an incoming transfer from a sender the issuer has blocked is held until Lumx compliance has read the trail of the funds. Contact operations@lumx.io if an address of yours is affected.
Should a business use a custodial or non-custodial wallet?
It depends on whether the business wants to run key management itself or hand it to a custodian with its own controls. Lumx wallets are custodial: BitGo holds the keys, balances are segregated per customer, and you can still send stablecoin to any external address.
USDC or USDT for business payments?
The right choice depends on which networks and counterparties you pay on, because USDC and USDT are not available on every chain. Lumx supports both: USDC on Ethereum, Polygon, Base and Stellar, USDT on Ethereum, Polygon and Tron, each convertible to BRL, USD, EUR, MXN and GBP.