Skip to main content

​
List All Chains

GET /chains Retrieve a list of all supported blockchains with their contract addresses and configuration.

​
Request

curl "https://api.1tx.fi/api/v1/chains"

​
Response

{
  "chains": [
    {
      "chainId": 8453,
      "name": "base",
      "displayName": "Base Mainnet",
      "blockExplorer": "https://basescan.org",
      "isTestnet": false,
      "contracts": {
        "instrumentRegistry": "0x94CC7106f7741FA2d374Ca7b808645fF43b6d2a3",
        "swapPoolRegistry": "0xe6C6e82970b5f320B8E3a97fA1aDa5e06fb168b4",
        "router": "0xbFdd5bEdC0cB9B8795A93C2a1fB634012C8F99bC",
        "quoter": "0x0d5e0f971ed27fbff6c2837bf31316121532048d",
        "cctpBridge": "0x76332AE6F24597cf37d38E5deB9f2f4172003E64",
        "cctpReceiver": "0xAA4a2CFd29734dA2041a56A716e408F1A610f85E",
        "adapters": {
          "aave": "0xBACC8882E2a9f5a67570E1BC10d87062dB68dfDd",
          "compound": "0x24fe3D7a9aAdD40033F0C19Ad10D1dF2ea6F7c1B",
          "morpho": "0x12A41B400ca8f81FD09DCcf83Be4632e681Ed2B5",
          "euler": "0x873C9fFCc888622EF322746F653Bce12450E0Fd8",
          "fluid": "0x5fD5b1EF0a8FE892e5bdBFbd35CeEc7B3B950372"
        }
      },
      "uniswap": {
        "poolManager": "0x498581ff718922c3f8e6a244956af099b2652b2b",
        "positionManager": "0x7c5f5a4bbd8fd63184577525326123b519429bdc",
        "swapRouter": "0x6fF5693b99212Da76ad316178A184AB56D299b43",
        "permit2": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
      },
      "cctp": {
        "supported": true,
        "domain": 6,
        "tokenMessenger": "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d",
        "messageTransmitter": "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64"
      },
      "tokens": {
        "USDC": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "EURC": "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
        "USDbC": "0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA",
        "GHO": "0x6Bb7a212910682DCFdbd5BCBb3e28FB4E8da10Ee",
        "USDS": "0xA88594D404727625A9437C3f886C7643872296AE",
        "DAI": "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb",
        "eUSD": "0xCfA3Ef56d303AE4fAabA0592388F19d7C3399FB4",
        "WETH": "0x4200000000000000000000000000000000000006"
      }
    }
  ],
  "total": 3
}

​
Response Fields

FieldTypeDescription
chainIdnumberThe blockchain’s chain ID
namestringInternal chain name (lowercase)
displayNamestringHuman-readable chain name
blockExplorerstringURL to the block explorer
isTestnetbooleanWhether this is a testnet
contractsobject1tx contract addresses
contracts.instrumentRegistrystringInstrumentRegistry contract address
contracts.swapPoolRegistrystringSwapPoolRegistry contract address
contracts.routerstringRouter contract address
contracts.quoterstringQuoter contract address
contracts.cctpBridgestringCCTP bridge adapter address
contracts.cctpReceiverstringCCTP receiver address
contracts.adaptersobjectProtocol adapter addresses
uniswapobjectUniswap V4 contract addresses
cctpobjectCCTP configuration for the chain
tokensobjectCommon token addresses on this chain

​
Get Single Chain

GET /chains/:chainId Retrieve detailed information about a specific blockchain.

​
Request

curl "https://api.1tx.fi/api/v1/chains/8453"

​
Path Parameters

ParameterTypeRequiredDescription
chainIdnumberYesThe chain ID (e.g., 8453 for Base)

​
Response

{
  "chainId": 8453,
  "name": "base",
  "displayName": "Base Mainnet",
  "blockExplorer": "https://basescan.org",
  "isTestnet": false,
  "contracts": {
    "instrumentRegistry": "0x94CC7106f7741FA2d374Ca7b808645fF43b6d2a3",
    "swapPoolRegistry": "0xe6C6e82970b5f320B8E3a97fA1aDa5e06fb168b4",
    "router": "0xbFdd5bEdC0cB9B8795A93C2a1fB634012C8F99bC",
    "quoter": "0x0d5e0f971ed27fbff6c2837bf31316121532048d",
    "cctpBridge": "0x76332AE6F24597cf37d38E5deB9f2f4172003E64",
    "cctpReceiver": "0xAA4a2CFd29734dA2041a56A716e408F1A610f85E",
    "adapters": {
      "aave": "0xBACC8882E2a9f5a67570E1BC10d87062dB68dfDd",
      "compound": "0x24fe3D7a9aAdD40033F0C19Ad10D1dF2ea6F7c1B",
      "morpho": "0x12A41B400ca8f81FD09DCcf83Be4632e681Ed2B5",
      "euler": "0x873C9fFCc888622EF322746F653Bce12450E0Fd8",
      "fluid": "0x5fD5b1EF0a8FE892e5bdBFbd35CeEc7B3B950372"
    }
  },
  "uniswap": {
    "poolManager": "0x498581ff718922c3f8e6a244956af099b2652b2b",
    "positionManager": "0x7c5f5a4bbd8fd63184577525326123b519429bdc",
    "swapRouter": "0x6fF5693b99212Da76ad316178A184AB56D299b43",
    "permit2": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
  },
  "cctp": {
    "supported": true,
    "domain": 6,
    "tokenMessenger": "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d",
    "messageTransmitter": "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64"
  },
  "tokens": {
    "USDC": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "EURC": "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
    "USDbC": "0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA",
    "GHO": "0x6Bb7a212910682DCFdbd5BCBb3e28FB4E8da10Ee",
    "USDS": "0xA88594D404727625A9437C3f886C7643872296AE",
    "DAI": "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb",
    "eUSD": "0xCfA3Ef56d303AE4fAabA0592388F19d7C3399FB4",
    "WETH": "0x4200000000000000000000000000000000000006"
  }
}

​
Error Responses

404 Not Found - Chain not supported 
{
  "statusCode": 404,
  "message": "Chain 1 not found or not supported"
}

​
TypeScript Example

const BASE_URL = 'https://api.1tx.fi/api/v1';

// Get all supported chains
async function getChains() {
  const response = await fetch(`${BASE_URL}/chains`);
  return response.json();
}

// Get specific chain details
async function getChain(chainId: number) {
  const response = await fetch(`${BASE_URL}/chains/${chainId}`);
  if (!response.ok) {
    throw new Error(`Chain ${chainId} not supported`);
  }
  return response.json();
}

// Usage
const { chains } = await getChains();
console.log(`Supported chains: ${chains.map(c => c.displayName).join(', ')}`);

// Get Base chain contracts
const baseChain = await getChain(8453);
console.log('InstrumentRegistry:', baseChain.contracts.instrumentRegistry);
console.log('Aave Adapter:', baseChain.contracts.adapters.aave);

​
Next Steps

Instruments API

Query DeFi instruments

Positions API

Query user positions