Skip to main content
POST
/
rpc
/
Trails
/
GetChains
Get Chains
curl --request POST \
  --url https://trails-api.sequence.app/rpc/Trails/GetChains \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Key: <api-key>' \
  --data '
{
  "routeProvider": "<string>"
}
'
{
  "chains": [
    {
      "id": 123,
      "name": "<string>",
      "tokenName": "<string>",
      "tokenSymbol": "<string>",
      "tokenDecimals": 123,
      "isTestnet": true,
      "supportsBridging": true,
      "logoUri": "<string>",
      "blockExplorerUrl": "<string>"
    }
  ]
}

​
Overview

The GetChains endpoint retrieves a list of all blockchain networks supported by Trails. This is useful for building chain selection UIs, validating user inputs, and discovering which networks are available for cross-chain transactions.

​
Use Cases

  • Build chain selection dropdowns in your UI
  • Validate that user-selected chains are supported
  • Display chain metadata (name, logo, native token)
  • Filter chains by bridging support
  • Identify testnet vs mainnet networks
  • Get block explorer URLs for transaction links

​
Request Parameters

​
Optional Fields

  • routeProvider (string): Filter chains by a specific route provider (e.g., “CCTP”, “LIFI”, “RELAY”)

​
Response

The response includes:
  • chains (ChainInfo[]): Array of supported chain information

​
ChainInfo Object Structure

Each chain object contains:
  • id (number): The chain ID
  • name (string): Human-readable chain name
  • tokenName (string): Native token name (e.g., “Ether”)
  • tokenSymbol (string): Native token symbol (e.g., “ETH”)
  • tokenDecimals (number): Native token decimals
  • isTestnet (boolean): Whether this is a testnet
  • supportsBridging (boolean): Whether bridging is supported on this chain
  • logoUri (string, optional): URL to chain logo
  • blockExplorerUrl (string, optional): Block explorer base URL

​
Examples

​
Get All Supported Chains

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetChains', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({})
});

const { chains } = await response.json();

console.log('Supported chains:', chains.length);
chains.forEach(chain => {
  console.log(`${chain.name} (${chain.id}): ${chain.tokenSymbol}`);
});

​
Filter by Route Provider

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetChains', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    routeProvider: 'CCTP' // Get chains supported by Circle's CCTP
  })
});

const { chains } = await response.json();

console.log('CCTP-supported chains:', chains.map(c => c.name));

​
Build Chain Selector UI

import { useEffect, useState } from 'react';

interface ChainInfo {
  id: number;
  name: string;
  tokenSymbol: string;
  logoUri?: string;
  isTestnet: boolean;
  supportsBridging: boolean;
}

export const ChainSelector = ({ 
  onSelect, 
  excludeTestnets = true 
}: { 
  onSelect: (chainId: number) => void;
  excludeTestnets?: boolean;
}) => {
  const [chains, setChains] = useState<ChainInfo[]>([]);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    fetch('https://trails-api.sequence.app/rpc/Trails/GetChains', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-Access-Key': 'YOUR_API_KEY'
      },
      body: JSON.stringify({})
    })
      .then(res => res.json())
      .then(({ chains }) => {
        const filtered = excludeTestnets 
          ? chains.filter((c: ChainInfo) => !c.isTestnet)
          : chains;
        setChains(filtered);
        setLoading(false);
      });
  }, [excludeTestnets]);

  if (loading) return <div>Loading chains...</div>;

  return (
    <select onChange={(e) => onSelect(Number(e.target.value))}>
      <option value="">Select a chain</option>
      {chains.map(chain => (
        <option key={chain.id} value={chain.id}>
          {chain.name} ({chain.tokenSymbol})
        </option>
      ))}
    </select>
  );
};

​
Get Chains with Bridging Support

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetChains', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({})
});

const { chains } = await response.json();

// Filter to only chains that support bridging
const bridgableChains = chains.filter(chain => chain.supportsBridging);

console.log('Chains with bridging support:');
bridgableChains.forEach(chain => {
  console.log(`- ${chain.name} (${chain.id})`);
});

​
Common Chain IDs

ChainChain IDNative Token
Ethereum1ETH
Polygon137MATIC
Arbitrum One42161ETH
Optimism10ETH
Base8453ETH
Avalanche43114AVAX
BNB Chain56BNB
Chain support is continuously expanding. Use this endpoint to get the current list rather than hardcoding chain IDs.

​
Next Steps

GetTokenList

Get available tokens for selected chains

QuoteIntent

Request a quote for cross-chain transactions

Authorizations

​
X-Access-Key
string
header
required

API Key for authenticating requests, get an access key at https://trails.build and request early access

Body

application/json
​
routeProvider
string

Response

Successful response

​
chains
object[]
required

[]ChainInfo