Skip to main content

List Blockchain Networks

This endpoint returns all blockchain networks supported by the platform (e.g., Ethereum, BSC, Polygon).

This listing is fundamental for cryptocurrency withdrawals to external wallets. Since USDT exists in several different blockchains, you need to specify which network the transfer should occur on so that the deposit arrives correctly.


Endpoint​

  • Method: GET
Endpoint URL
https://api.xgateglobal.com/deposit/company/blockchain-networks

Test Integration​

Use the form below to view the available networks.

🔗

Test: List Blockchain Networks

1. Your Credentials

Request​

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

Required Headers​

HeaderValueDescription
AuthorizationBearer <your_token>The JWT token obtained from login.

Responses​

Success (200 OK)​

Returns the list of networks.

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

StatusMessageLikely Reason
401Unauthorized• Invalid or expired token.
• Invalid or missing Header.
• IP not allowed.
500Internal Server ErrorInternal server error. Contact support.

How to use​

To perform a Crypto Deposit (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 USDT or USDC is the cargo (the money) and the Blockchain Network is the highway the cargo will travel on. We work with the following networks:

  • 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.
Important

If your client provides a Solana network wallet address, you must select the Solana network from this list. Sending via the wrong network (e.g., sending to a Tron address using the Ethereum network) will result in transaction failure and the possible permanent loss of funds.

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 chosen network's object and insert it into the blockchainNetwork field of the withdrawal payload.

Practical Example​

1. Network object that you received from 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 it in the Crypto Withdrawal (POST /withdraw):

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

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

Integration​

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