> ## Documentation Index
> Fetch the complete documentation index at: https://docs.settlx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Chains

> Retrieve all supported blockchain networks and their tokens

# List Chains

Returns all enabled blockchain networks supported by Settlx, along with the tokens available on each chain.

This endpoint does **not** require authentication. Use it to populate chain and token selectors in your checkout UI.

## Response

<ResponseField name="data" type="array">
  <Expandable title="Chain objects">
    <ResponseField name="name" type="string">
      Chain identifier used in other API calls (e.g. `ethereum`, `bsc`, `solana`, `tron`, `bitcoin`)
    </ResponseField>

    <ResponseField name="displayName" type="string">
      Human-readable chain name (e.g. `Ethereum`, `BNB Smart Chain`)
    </ResponseField>

    <ResponseField name="chainType" type="string">
      Chain type. One of: `evm`, `solana`, `tron`, `bitcoin`
    </ResponseField>

    <ResponseField name="nativeCurrency" type="string">
      Native currency symbol (e.g. `ETH`, `BNB`, `SOL`, `TRX`, `BTC`)
    </ResponseField>

    <ResponseField name="supportedTokens" type="array">
      List of tokens supported on this chain, including the native currency.

      Each token contains:

      * `symbol` — token symbol (e.g. `USDT`)
      * `name` — full token name (e.g. `Tether USD`)
      * `contractAddress` — contract address (`null` for native currencies)
      * `decimals` — token decimals
      * `standard` — token standard (`NATIVE`, `ERC20`, `TRC20`, `SPL`, etc.)
      * `iconUrl` — token icon URL (may be `null`)
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.settlx.io/api/v1/chains
  ```

  ```javascript Browser / Node.js theme={null}
  const response = await fetch('https://api.settlx.io/api/v1/chains');
  const { data: chains } = await response.json();

  chains.forEach(chain => {
    console.log(`${chain.displayName}: ${chain.supportedTokens.length} tokens`);
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "name": "ethereum",
        "displayName": "Ethereum",
        "chainType": "evm",
        "nativeCurrency": "ETH",
        "supportedTokens": [
          {
            "symbol": "ETH",
            "name": "Ether",
            "contractAddress": null,
            "decimals": 18,
            "standard": "NATIVE",
            "iconUrl": null
          },
          {
            "symbol": "USDT",
            "name": "Tether USD",
            "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
            "decimals": 6,
            "standard": "ERC20",
            "iconUrl": "https://cdn.settlx.io/tokens/usdt.png"
          },
          {
            "symbol": "USDC",
            "name": "USD Coin",
            "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "decimals": 6,
            "standard": "ERC20",
            "iconUrl": "https://cdn.settlx.io/tokens/usdc.png"
          }
        ]
      },
      {
        "name": "tron",
        "displayName": "Tron",
        "chainType": "tron",
        "nativeCurrency": "TRX",
        "supportedTokens": [
          {
            "symbol": "TRX",
            "name": "TRON",
            "contractAddress": null,
            "decimals": 6,
            "standard": "NATIVE",
            "iconUrl": null
          },
          {
            "symbol": "USDT",
            "name": "Tether USD",
            "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
            "decimals": 6,
            "standard": "TRC20",
            "iconUrl": "https://cdn.settlx.io/tokens/usdt.png"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>