Get Supported Chains

Get a list of all blockchain networks supported by the Tachyon relay service, including chain details, native currency information, and block explorer URLs.

Endpoint

endpoint


GET https://api.tachyon.rath.fi/api/supported-chains

Parameters

This endpoint requires no parameters.

Response

Success Response

response.json


{
  "success": true,
  "data": [
    {
      "id": 8453,
      "name": "Base",
      "iconUrl": "https://d1tmxgi96tgufh.cloudfront.net/chains/Base.png",
      "isTestnet": false,
      "nativeCurrency": {
        "name": "Ether",
        "symbol": "ETH",
        "decimals": 18
      },
      "blockExplorers": {
        "default": {
          "name": "Basescan",
          "url": "https://basescan.org",
          "apiUrl": "https://api.basescan.org/api"
        }
      }
    },
    {
      "id": 1,
      "name": "Ethereum",
      "iconUrl": "https://d1tmxgi96tgufh.cloudfront.net/chains/Ethereum.png",
      "isTestnet": false,
      "nativeCurrency": {
        "name": "Ether",
        "symbol": "ETH",
        "decimals": 18
      },
      "blockExplorers": {
        "default": {
          "name": "Etherscan",
          "url": "https://etherscan.io",
          "apiUrl": "https://api.etherscan.io/api"
        }
      }
    },
    {
      "id": 137,
      "name": "Polygon",
      "iconUrl": "https://d1tmxgi96tgufh.cloudfront.net/chains/Polygon.png",
      "isTestnet": false,
      "nativeCurrency": {
        "name": "MATIC",
        "symbol": "MATIC",
        "decimals": 18
      },
      "blockExplorers": {
        "default": {
          "name": "PolygonScan",
          "url": "https://polygonscan.com",
          "apiUrl": "https://api.polygonscan.com/api"
        }
      }
    },
    {
      "id": 88888888,
      "name": "Aptos",
      "iconUrl": "https://d1tmxgi96tgufh.cloudfront.net/chains/APT.png",
      "isTestnet": false,
      "nativeCurrency": {
        "name": "Aptos Coin",
        "symbol": "APT",
        "decimals": 8
      },
      "blockExplorers": {
        "default": {
          "name": "Aptos Explorer",
          "url": "https://explorer.aptoslabs.com",
          "apiUrl": "https://api.mainnet.aptoslabs.com/v1"
        }
      }
    },
    {
      "id": 10100000,
      "name": "Solana",
      "iconUrl": "https://d1tmxgi96tgufh.cloudfront.net/chains/Solana.png",
      "isTestnet": false,
      "nativeCurrency": {
        "name": "Solana",
        "symbol": "SOL",
        "decimals": 9
      },
      "blockExplorers": {
        "default": {
          "name": "Solscan",
          "url": "https://solscan.io",
          "apiUrl": "https://api.solscan.io"
        }
      }
    },
    {
      "id": 7777777,
      "name": "NEAR",
      "iconUrl": "https://d1tmxgi96tgufh.cloudfront.net/chains/NEAR.png",
      "isTestnet": false,
      "nativeCurrency": {
        "name": "NEAR",
        "symbol": "NEAR",
        "decimals": 24
      },
      "blockExplorers": {
        "default": {
          "name": "NEAR Explorer",
          "url": "https://nearblocks.io",
          "apiUrl": "https://api.nearblocks.io/v1"
        }
      }
    }
  ],
  "timestamp": "2025-10-24T12:34:56.789Z"
}

Chain Object Fields

Field	Type	Description
`id`	number	Unique blockchain network identifier (chain ID)
`name`	string	Human-readable name of the blockchain
`iconUrl`	string	URL to the chain’s icon/logo image
`isTestnet`	boolean	Whether this is a testnet (`true`) or mainnet (`false`)
`nativeCurrency`	object	Information about the chain’s native currency
`blockExplorers`	object	Block explorer information for the chain

Native Currency Object

Field	Type	Description
`name`	string	Full name of the native currency
`symbol`	string	Symbol/ticker of the native currency
`decimals`	number	Number of decimal places for the currency

Block Explorers Object

Field	Type	Description
`default.name`	string	Name of the default block explorer
`default.url`	string	URL of the block explorer website
`default.apiUrl`	string	API endpoint URL for the block explorer

Error Response

error-response.json


{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Failed to fetch supported chains",
    "category": "SERVER_ERROR",
    "traceId": "trace_abc123xyz789"
  },
  "timestamp": "2025-10-24T12:34:56.789Z"
}

Example Request

terminal


curl "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY"

With Formatted Output (jq)

terminal


curl "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY" | jq '.data[] | {
    id: .id,
    name: .name,
    isTestnet: .isTestnet,
    currency: .nativeCurrency.symbol
  }'

Example Output:

example-output.json


{
  "id": 8453,
  "name": "Base",
  "isTestnet": false,
  "currency": "ETH"
}
{
  "id": 1,
  "name": "Ethereum",
  "isTestnet": false,
  "currency": "ETH"
}
{
  "id": 137,
  "name": "Polygon",
  "isTestnet": false,
  "currency": "MATIC"
}

Filter Mainnet Chains Only

terminal


curl "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY" | jq '.data[] | select(.isTestnet == false)'

Filter Testnet Chains Only

terminal


curl "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY" | jq '.data[] | select(.isTestnet == true)'

Get Chain by ID

terminal


# Get information for Base (chain ID 8453)
curl "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY" | jq '.data[] | select(.id == 8453)'

List All Chain IDs and Names

terminal


curl "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY" | jq -r '.data[] | "\(.id) - \(.name)"'

Example Output:

output.txt


8453 - Base
1 - Ethereum
137 - Polygon
42161 - Arbitrum One
10 - Optimism
88888888 - Aptos
10100000 - Solana
7777777 - NEAR

Use Cases

Dynamic Chain Selection

Populate a chain selector in your application UI:

terminal


# Get chain data for a dropdown menu
curl "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY" | jq '.data[] | {
    value: .id,
    label: .name,
    icon: .iconUrl,
    disabled: .isTestnet
  }'

Chain Validation

Validate if a chain ID is supported before submitting transactions:

chain-validation.sh


#!/bin/bash
 
CHAIN_ID=8453
RESPONSE=$(curl -s "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY")
 
IS_SUPPORTED=$(echo $RESPONSE | jq --arg id "$CHAIN_ID" '.data[] | select(.id == ($id | tonumber)) | .id')
 
if [ -n "$IS_SUPPORTED" ]; then
  echo "Chain ID $CHAIN_ID is supported"
else
  echo "Chain ID $CHAIN_ID is not supported"
fi

Get Block Explorer URLs

Retrieve block explorer information for transaction tracking:

terminal


# Get block explorer for Base
curl "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY" | jq '.data[] | select(.id == 8453) | .blockExplorers.default'

Example Output:

block-explorer.json


{
  "name": "Basescan",
  "url": "https://basescan.org",
  "apiUrl": "https://api.basescan.org/api"
}

Currency Information Lookup

Get native currency details for balance display:

terminal


# Get currency info for multiple chains
curl "https://api.tachyon.rath.fi/api/supported-chains" \
  -H "apikey: YOUR_API_KEY" | jq '.data[] | {
    chain: .name,
    currency: .nativeCurrency.symbol,
    decimals: .nativeCurrency.decimals
  }'

Response Notes

Chain IDs: Unique identifiers following blockchain standards
- EVM chains use standard chain IDs (e.g., 1 for Ethereum, 8453 for Base)
- Non-EVM chains use custom identifiers (e.g., 88888888 for Aptos)
Decimals: Important for amount conversion
- EVM chains typically use 18 decimals
- Solana uses 9 decimals (lamports)
- NEAR uses 24 decimals (yoctoNEAR)
- Aptos uses 8 decimals (octas)
Testnet Chains: Can be filtered using the isTestnet field
- false: Mainnet chain (production use)
- true: Testnet chain (development/testing)