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 } }
    }
  ]
}
Dica

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. Consulte tokenInfo.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.