Assets & Networks
Every asset the Hodle API supports, the networks it lives on, and which endpoints can move it.
One table per direction. asset and network are always validated together: an unsupported
pair returns 400, and an asset behind a feature flag returns 403 rather than silently
falling back to another asset.
On-ramp — POST /api/deposit/asset
BRL (PIX) in, crypto out to any address you pass.
| Asset | Networks | Address format |
|---|---|---|
LIGHTNING | lightning | BOLT11 invoice or LNURL email |
BTC | bitcoin | Bitcoin address |
USDT | polygon, arbitrum | EVM address (0x...) |
USDC | polygon, base, gnosis | EVM address (0x...) |
USDCE | gnosis | EVM address (0x...) |
BRLA | polygon, base | EVM address (0x...) |
DEPIX | liquid | Liquid address |
LBTC | liquid | Liquid address |
BRS is not available on this endpoint — it is minted only to the user's own Hodle
Solana wallet. See BRS.
Transfer — POST /api/wallet/transfer
Move a balance the user already holds to another Hodle wallet or an external address. Gas is sponsored.
| Network | Assets | Default | Notes |
|---|---|---|---|
polygon | USDT, USDC, BRLA | USDT | USDT is ledger-backed |
base | USDC, BRLA | — | |
solana | USDT, USDC, BRS | — | SPL transferChecked; BRS needs NORA_RAIL |
Off-ramp — POST /api/wallet/payout
Balance in, BRL (PIX) out.
| Network | Assets | Default | Notes |
|---|---|---|---|
polygon | USDT, BRLA | USDT | |
base | USDC, BRLA | USDC | |
tron | USDT | USDT | asset ignored; needs TRON_PAYOUT |
solana | USDT, USDC, BRS | USDT | BRS needs NORA_RAIL |
Lightning off-ramp is a separate endpoint —
/api/lightning/invoice.
BRL-pegged vs USD-pegged
| Asset | Peg | Conversion to the PIX amount |
|---|---|---|
BRLA | BRL | 1:1, no FX |
BRS | BRL | 1:1, no FX — see BRS |
DEPIX | BRL | 1:1, no FX |
USDT | USD | Converted at the current BRL rate (quote) |
USDC | USD | Converted at the current BRL rate (quote) |
USDCE | USD | Converted at the current BRL rate (quote) |
Assets behind a feature flag
| Asset / network | Flag required (on top of WALLET_PAYOUT_API) | Without it |
|---|---|---|
BRS (solana) | NORA_RAIL | 403 |
USDT (tron) | TRON_PAYOUT | 403 |
Contact Hodle to enable a flag on an account.
Balances
POST /api/wallet/get returns addresses and balances for polygon,
base, tron, liquid and spark. Solana addresses and BRS balances are not exposed
there yet — read them on-chain from the user's Solana address, or reconcile through the
account statement.
Sandbox
The sandbox settles on Base Sepolia with a test token (USDB). Solana —
and therefore BRS — is production-only.