Pular para o conteúdo principal

Listar Redes Blockchain

Este endpoint retorna todas as redes blockchain suportadas pela plataforma (ex: Ethereum, Polygon, Tron e Solana).

Esta listagem é fundamental para realizar saques de criptomoedas para carteiras externas. Como as stablecoins USDT e USDC são ativos multichain presentes em várias blockchains diferentes, você deve especificar obrigatoriamente em qual rede a transferência deve ocorrer ao montar o payload de saque para evitar a perda de fundos.

Endpoint​

  • Método: GET
URL do Endpoint
https://api.xgateglobal.com/withdraw/company/blockchain-networks

Testar Integração​

Utilize o formulário abaixo para visualizar as redes disponíveis.

🔗

Testar: Listar Redes Blockchain

1. Suas Credenciais

Requisição​

A requisição não requer corpo (body), apenas os Headers de autenticação.

Headers Obrigatórios​

HeaderValorDescrição
AuthorizationBearer <seu_token>O token JWT obtido no login.

Respostas (Responses)​

Sucesso (200 OK)​

Retorna a lista de redes. Você precisará do objeto completo da rede escolhida.

[
  {
    "_id": "672c15919**************",
    "name": "ERC-20",
    "chainId": "1",
    "cryptocurrencies": [...],
    "updatedDate": "2024-1**************",
    "createdDate": "2024-1**************",
    "__v": 0,
    "chain": "Ethereum",
    "uid": "01KH7NPXAX**************"
  },
  {
    "_id": "672c19adc**************",
    "name": "Polygon",
    "chainId": "137",
    "cryptocurrencies": [...],
    "updatedDate": "2024-1**************",
    "createdDate": "2024-1**************",
    "__v": 0,
    "chain": "Polygon",
    "symbol": "MATIC",
    "uid": "01KH7N1B2D**************"
  },
  {
    "_id": "69ea823198**************",
    "__v": 0,
    "chain": "Tron",
    "chainId": "728126428",
    "createdDate": "2026-0**************",
    "cryptocurrencies": [...],
    "name": "TRC-20",
    "symbol": "TRX",
    "uid": "01KHM0PNDZBSGFDE7DP6AQA72N",
    "updatedDate": "2026-0**************"
  },
  {
    "_id": "69ea849098**************",
    "__v": 0,
    "chain": "Solana",
    "createdDate": "2026-0**************",
    "cryptocurrencies": [...],
    "name": "Solana",
    "symbol": "SOL",
    "uid": "01KKZWMEH6**************",
    "updatedDate": "2026-0**************"
  }
]

Erros Comuns​

StatusMensagemMotivo Provável
401Unauthorized• Token inválido ou expirado.
• Header inválido ou não informado.
• IP não permitido.
500Internal Server ErrorErro interno de servidor. Entrar em contato com suporte.

Como usar​

Para realizar um Saque Crypto (enviar USDT ou USDC da XGate para uma carteira externa), não basta informar a moeda e o valor. É obrigatório informar a Rede (Blockchain Network).

O que são essas Redes?​

Imagine que a criptomoeda é a carga (o dinheiro) e a Rede Blockchain é a rodovia por onde essa carga vai passar. Nós trabalhamos principalmente com:

  • Ethereum / ERC-20: A rede principal do Ethereum. Geralmente possui taxas de gás mais elevadas.
  • Polygon: Uma rede criada para resolver o problema de escala do Ethereum, oferecendo transações rápidas e com baixo custo.
  • Tron (TRC-20): Extremamente popular para transações de stablecoins (utilizada apenas para transações USDT na XGate), conhecida por sua alta velocidade e taxas muito reduzidas.
  • Solana: Uma das redes mais rápidas e eficientes do mercado atual, destacando-se por custos de transação quase nulos.
Atenção

Se o seu cliente fornecer um endereço de carteira da rede Polygon, você deve selecionar a rede Polygon nesta listagem. Enviar pela rede errada (ex: enviar para um endereço Polygon usando a rede Ethereum) pode resultar em falha na transação ou custos elevados desnecessários.

O Fluxo de Integração​

  1. Consulte as Redes: Chame este endpoint para obter as opções disponíveis e seus IDs.
  2. Selecione a Rede: Deixe seu usuário escolher (ex: "Selecione a rede de destino: ERC-20, TRC-20, Solana ou Polygon") ou selecione via sistema com base no endereço da carteira.
  3. Monte o Payload: Pegue o objeto completo da rede escolhida e insira no campo blockchainNetwork do payload de saque.

Exemplo Prático​

1. Objeto de Rede que você recebeu nesta listagem (ex: SOLANA):

{
  "_id": "69ea849098**************",
  "__v": 0,
  "chain": "Solana",
  "createdDate": "2026-0**************",
  "cryptocurrencies": [...],
  "name": "Solana",
  "symbol": "SOL",
  "uid": "01KKZWMEH6**************",
  "updatedDate": "2026-0**************"
}

2. Como enviar no Saque Crypto (POST /withdraw):

Observe como o objeto acima é injetado no campo blockchainNetwork:

{
    "amount": 2,
    "customerId": "6759a16f20***************",
    "cryptocurrency": {
        "_id": "67c0dd903***************",
        "name": "USDT",
        "symbol": "USDT"
    },
    "blockchainNetwork": {
      "_id": "69ea849098**************",
      "chain": "Solana",
      "name": "Solana",
      "symbol": "SOL"
    },
    "wallet": "0x7A00e4a***************",
    "externalId": "6dd37763a2***************"
}

Integração​

O exemplo de integração utiliza a biblioteca Axios em Node.js.

Instalando Axios:

npm install axios

Exemplo Javascript:

const axios = require("axios");

(async () => {
    const email = "your_email@domain.com";
    const password = "**********";

    try {
        const url_api = "https://api.xgateglobal.com"
        const login = await axios.post(`${url_api}/auth/token`, { email, password });
        const { data } = await axios.get(`${url_api}/withdraw/company/blockchain-networks`, {
            headers: {
                "Authorization": `Bearer ${login.data.token}`
            }
        });
        console.log(data); // Response
    } catch (error) {
        console.log(error.response.data.message) // Error
    }
})()