Referência
Moedas e redes
Ativos, redes configuradas e descoberta de disponibilidade pela API.
A configuração do backend contempla as redes EVM Base, Polygon PoS, Arbitrum One e Optimism. A disponibilidade efetiva depende da configuração e da saúde de cada rede; não presuma que todas estejam ativas. Consulte GET /api/crypto/v1/chains antes de apresentar opções ao cliente.
| Rede | Ativos configurados | Moeda de gás |
|---|---|---|
| Base | USDT, USDC, EURC, BRZ | ETH |
| Polygon | USDT, USDC, BRZ | POL |
| Arbitrum | USDT, USDC | ETH |
| Optimism | USDT, USDC | ETH |
Os pares disponíveis no ambiente e no contrato podem ser diferentes da configuração acima. EURC exige escolha explícita; o roteamento automático prefere BRZ, USDT e USDC. A resposta também apresenta informações de testnets quando configuradas.
Descobrindo as redes em tempo real
O endpoint público GET /api/crypto/v1/chains devolve as redes ativas do
gateway, com os tokens aceitos em cada uma:
curl https://api.caedral.com/api/crypto/v1/chains
{
"chains": [
{
"name": "base",
"label": "Base",
"tokens": ["USDT", "USDC"],
"tokenInfo": { "USDT": { "decimals": 6 } }
}
]
}
Use este endpoint para popular o seletor de rede/ativo do seu checkout em vez de fixar a lista no código — redes novas aparecem automaticamente.
Parâmetros de carteira (chainParams)
Toda ordem devolve o objeto chainParams, pronto para o padrão
wallet_addEthereumChain das carteiras EVM:
| Campo | Exemplo | Descrição |
|---|---|---|
chainIdHex |
0x2105 |
Chain ID em hexadecimal |
chainName |
Base |
Nome de exibição |
rpcUrls |
["https://…"] |
RPC público da rede |
nativeSymbol |
ETH |
Símbolo do gás |
blockExplorerUrls |
["https://basescan.org"] |
Explorer base |
Cotação e decimais
- A cotação BRL→USD vem da AwesomeAPI, com cache de 60 segundos;
- O valor em cripto é calculado como
amountBRL / rate × (1 + spread), convertido para as unidades do token. ConsultetokenInfo.decimals: USDT, USDC e EURC usam 6 decimais; BRZ usa 18; - A taxa de câmbio fica travada por 15 minutos desde a criação da ordem;
- O spread aplicado é configurável por ambiente (
SPREAD_BPS, em basis points).
Na consulta à API oficial em 8 de novembro de 2026, as quatro redes acima apareciam disponíveis e o mínimo informado era de US$ 1 por ordem. Consulte o endpoint novamente antes de criar pedidos, pois configuração e disponibilidade podem mudar.