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."
  }
}