Listar redes blockchain

Este endpoint recupera todas las redes blockchain compatibles con la plataforma (por ejemplo, Ethereum, BSC, Polygon y redes integradas recientemente).

Esta lista es esencial para realizar retiros de criptomonedas a billeteras externas. Dado que stablecoins como USDT y USDC son activos multichain disponibles en varias blockchains, debe especificar la red correcta al construir el payload del retiro para evitar cualquier pérdida de fondos.

---

Endpoint

• Método: GET

URL del endpoint

https://api.xgateglobal.com/withdraw/company/blockchain-networks

---

Prueba de integración

Utilice el formulario a continuación para ver las redes disponibles.

🔗

Probar: Listar Redes Blockchain

1. Sus Credenciales

Correo electrónico

Contraseña

---

Solicitud

La solicitud no requiere cuerpo, solo los encabezados de autenticación.

Encabezados obligatorios

Encabezado	Valor	Descripción
Authorization	Bearer <tu_token>	El token JWT obtenido al iniciar sesión.

---

Respuestas

Éxito (200 OK)

Devuelve la lista de redes. Necesitará el objeto completo de la red seleccionada.

[
  {
    "_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**************"
  }

Errores comunes

Estado	Mensaje	Posible causa
401	Unauthorized	• Token inválido o vencido. • Encabezado inválido o faltante. • IP no permitida.
500	Internal Server Error	Error interno del servidor. Contacte con soporte.

---

Cómo usar

Para realizar un Retiro Crypto (enviar USDT o USDC de XGate a una billetera externa), no basta con informar la moneda y el monto. Es obligatorio especificar la Red (Blockchain Network).

¿Qué son estas Redes?

Imagina que la criptomoneda es la carga (el dinero) y la Red Blockchain es la autopista por donde pasará esa carga. Trabajamos principalmente con:

• Ethereum / ERC-20: La red principal de Ethereum. Generalmente tiene tarifas de gas más altas.
• Polygon: Una red creada para resolver el problema de escalabilidad de Ethereum, ofreciendo transacciones rápidas y de bajo costo.
• Tron (TRC-20): Extremadamente popular para transacciones de stablecoins (utilizada solo para transacciones de USDT en XGate), conocida por su alta velocidad y tarifas muy reducidas.
• Solana: Una de las redes más rápidas y eficientes del mercado actual, destacando por sus costos de transacción casi nulos.

Atención

Si tu cliente proporciona una dirección de billetera de la red Polygon, debes seleccionar la red Polygon en este listado. Enviar por la red equivocada (ej.: enviar a una dirección Polygon usando la red Ethereum) puede resultar en una falla en la transacción o en costos elevados innecesarios.

El Flujo de Integración

1. Consulta las Redes: Llama a este endpoint para obtener las opciones disponibles y sus IDs.
2. Selecciona la Red: Deja que tu usuario elija (ej.: "Selecciona la red de destino: ERC-20, TRC-20, Solana o Polygon") o selecciónala por sistema basándote en la dirección de la billetera.
3. Arma el Payload: Toma el objeto completo de la red elegida e insértalo en el campo blockchainNetwork del payload de retiro.

Ejemplo práctico

1. Objeto de red que recibió en esta lista (por ejemplo, SOLANA):

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

2. Cómo enviarlo en el retiro de criptomonedas (POST /withdraw):

Observe cómo el objeto anterior se inserta en el 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***************"
}

---

Integración

Node.js

Este ejemplo de integración utiliza la librería Axios en Node.js.

Instalando Axios:

npm install axios

Ejemplo en 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); // Respuesta
    } catch (error) {
        console.log(error.response.data.message) // Error
    }
})()