List Blockchain Networks

This endpoint retrieves all blockchain networks supported by the platform (e.g., Ethereum, Polygon, Tron e Solana).

This listing is essential for performing cryptocurrency withdrawals to external wallets. Since stablecoins like USDT and USDC are multichain assets available across various blockchains, you must specify the correct network when constructing the withdrawal payload to prevent any loss of funds.

---

Endpoint

• Method: GET

Endpoint URL

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

---

Test Integration

Use the form below to view the available networks.

🔗

Test: List Blockchain Networks

1. Your Credentials

Email

Password

---

Request

The request does not require a body, only authentication Headers.

Required Headers

Header	Value	Description
Authorization	Bearer <your_token>	The JWT token obtained at login.

---

Responses

Success (200 OK)

Returns the list of networks. You will need the complete object of the chosen network.

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

Common Errors

Status	Message	Likely Reason
401	Unauthorized	• Invalid or expired token. • Invalid or missing header. • IP not allowed.
500	Internal Server Error	Internal server error. Contact support.

---

How to use

To perform a Crypto Withdrawal (sending USDT or USDC from XGate to an external wallet), providing just the currency and the amount isn't enough. It is mandatory to specify the Blockchain Network.

What are these Networks?

Imagine that the cryptocurrency is the cargo (the money) and the Blockchain Network is the highway the cargo will travel on. We primarily work with:

• Ethereum / ERC-20: The main Ethereum network. It generally has higher gas fees.
• Polygon: A network created to solve Ethereum's scaling issues, offering fast and low-cost transactions.
• Tron (TRC-20): Extremely popular for stablecoin transactions (used only for USDT transactions on XGate), known for its high speed and very low fees.
• Solana: One of the fastest and most efficient networks on the market today, standing out for near-zero transaction costs.

Attention

If your client provides a Polygon network wallet address, you must select the Polygon network from this list. Sending via the wrong network (e.g., sending to a Polygon address using the Ethereum network) can result in transaction failure or unnecessarily high costs.

The Integration Flow

1. Consult the Networks: Call this endpoint to retrieve the available options and their IDs.
2. Select the Network: Let your user choose (e.g., "Select the destination network: ERC-20, TRC-20, Solana, or Polygon") or systematically select it based on the wallet address.
3. Build the Payload: Take the complete object of the chosen network and insert it into the blockchainNetwork field of the withdrawal payload.

Practical Example

1. Network object you received in this listing (e.g., SOLANA):

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

2. How to send in Crypto Withdrawal (POST /withdraw):

Notice how the object above is injected in the blockchainNetwork field:

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

---

Integration

Node.js

The integration example uses the Axios library in Node.js.

Installing Axios:

npm install axios

JavaScript Example:

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
    }
})()