API · Descoberta
Listar redes
GET /api/crypto/v1/chains — consulte redes, ativos e roteamento.
GET /api/crypto/v1/chains
Retorna as redes disponíveis no ambiente, informações dos tokens, testnets e a política de roteamento. Não exige autenticação.
Requisição
Não há parâmetros de entrada.
curl "https://api.caedral.com/api/crypto/v1/chains"
Resposta 200
chains é uma lista de redes. Cada item pode conter name, chainId, label, minOrderUsd, networkCostRank, tokens e tokenInfo. Em tokenInfo, cada ativo informa endereço, decimais, nome e dados de cotação. testnets lista as redes de teste e seu estado; routing descreve a seleção automática.
Consulte este endpoint ao construir o seletor: pares e disponibilidade dependem da configuração. O roteamento automático prefere BRZ, USDT e USDC; EURC requer escolha explícita. O campo decimals deve ser usado para calcular unidades brutas: por exemplo, BRZ na Base tem 18 e USDC tem 6.
Erros
500: falha interna ao montar a lista. Tente novamente com backoff.
Exemplo de resposta 200
Exemplo reduzido a uma rede e um ativo; a lista completa depende do ambiente.
{
"chains": [
{
"name": "base",
"chainId": 8453,
"label": "Base",
"minOrderUsd": 1,
"networkCostRank": 1,
"tokens": [
"USDC"
],
"tokenInfo": {
"USDC": {
"address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"decimals": 6,
"label": "USD Coin",
"quoteTtlMin": 15,
"verified": "official"
}
}
}
],
"testnets": [],
"routing": {
"mode": "auto",
"tokenPreference": [
"BRZ",
"USDT",
"USDC"
],
"note": "Sem chain/token o gateway roteia para a rede saudável de menor custo que atenda o pedido. EURC só por escolha explícita."
}
}