Chains

The XSwap Chains Metadata API provides detailed information on supported blockchains - you can fetch all chains, filter by ecosystem, or retrieve a single chain by its ID.

---

Endpoint

GET https://xswap.link/api/chains/v1
Content-Type: application/json

All query parameters are passed as a JSON payload in the data query parameter, URL-encoded.

---

Request

Required Parameters

Field	Type	Description
integratorId	string	Your registered integrator ID

Optional Parameters

Field	Type	Description
ecosystem	string	Filter by ecosystem (e.g. "EVM"). Currently only EVM is supported
chainIds	string[]	Chain IDs (e.g. ["1", "56"])

---

Response

The endpoint returns a JSON array of objects matching the model defined in the table below.

Field	Type	Description
ecosystem	string	Chain ecosystem identifier (currently only "EVM" supported)
chainId	string	Chain ID (e.g. "1", "56", "137")
name	string	Human-readable name (e.g. "Ethereum")
ccipChainId	number	CCIP chain ID for cross-chain messaging
tokenSymbol	string	Native token symbol (e.g. "ETH", "MATIC")
bridgeSupported	boolean	true if cross-chain bridging is supported
swapSupported	boolean	true if single-chain swaps are supported
supportedDstForBridge	string[]	List of chain IDs you can bridge to (e.g. ["56","137"])
supportedDstForSwap	string[]	List of chain IDs you can swap to (e.g. ["56","137"])

---

Example Request

;(async () => {
  const payload = {
    integratorId: "xxx"
  };

  const encoded = encodeURIComponent(JSON.stringify(payload));
  const url = `https://xswap.link/api/chains/v1?data=${encoded}`;

  const res = await fetch(url, {
    method: "GET",
    headers: { "Content-Type": "application/json" },
  });
  const chains = await res.json();
  console.log("All chains:", chains);
})();

Example Response

[
    {
        "ecosystem": "evm",
        "chainId": "1",
        "name": "ethereum",
        "ccipChainId": "5009297550715157269",
        "tokenSymbol": "ETH",
        "bridgeSupported": true,
        "swapSupported": true,
        "supportedDstForBridge": ["42161", "592", ...],
        "supportedDstForSwap": ["1", "42161", ...]
    },
    {
        "ecosystem": "solana",
        "chainId": "mainnet-beta",
        "name": "solana",
        "ccipChainId": "124615329519749607",
        "tokenSymbol": "SOL",
        "bridgeSupported": true,
        "swapSupported": true,
        "supportedDstForBridge": ["56", "8453", ...],
        "supportedDstForSwap": ["mainnet-beta", ...]
    },
    ...
]