> For the complete documentation index, see [llms.txt](https://docs.butternetwork.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.butternetwork.io/butter-swap-integration/butter-api-for-routing/get-supportedtokenlist.md).

# GET /supportedTokenList

GET a list of mainstream tokens for every supported chain or for one specified chain.

### Request Parameters

| Name      | Location | Type   | Required | Description                                                                                           |
| --------- | -------- | ------ | -------- | ----------------------------------------------------------------------------------------------------- |
| `chainId` | query    | string | no       | Chain ID to filter by. Omit it to return token groups for every chain supported by the Butter Router. |

> **Authentication**: this endpoint supports API Key authentication. See [Integration Guide - Authentication](/butter-swap-integration/integration-guide.md#authentication) for details.

### Request Examples

Get token groups for every supported chain:

```bash
GET /supportedTokenList
```

Get the token group for Ethereum only:

```bash
GET /supportedTokenList?chainId=1
```

### Response Structure

| Field     | Type   | Description                                                                                                                                                 |
| --------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `errno`   | number | Error code. `0` means success; other values indicate errors. See the [error code list](/butter-swap-integration/butter-api-for-routing/error-code-list.md). |
| `message` | string | Response message. A successful request returns `success`; otherwise it contains the corresponding error message.                                            |
| `data`    | array  | Mainstream tokens grouped by chain.                                                                                                                         |

Each item in `data` contains:

| Field     | Type   | Description                                                 |
| --------- | ------ | ----------------------------------------------------------- |
| `chainId` | number | Supported chain ID.                                         |
| `tokens`  | array  | Mainstream token list for the chain. May be an empty array. |

Each item in `tokens` contains:

| Field               | Type           | Description                                                             |
| ------------------- | -------------- | ----------------------------------------------------------------------- |
| `id`                | number         | Chain identifier used by the token record; currently matches `chainId`. |
| `chainId`           | number         | Chain ID for the token.                                                 |
| `address`           | string         | Token address in the chain's address format.                            |
| `blockchainNetwork` | string         | Chain ID represented as a string.                                       |
| `coingeckoId`       | string         | CoinGecko identifier field; currently an empty string.                  |
| `decimals`          | number         | Number of token decimals.                                               |
| `image`             | string         | Token icon URL.                                                         |
| `name`              | string         | Token name.                                                             |
| `rank`              | number         | Client sorting rank; currently `0`.                                     |
| `symbol`            | string         | Token symbol.                                                           |
| `tokenSecurity`     | string or null | Token security metadata field; currently `null`.                        |
| `usdprice`          | number         | Token USD price field; currently `0`.                                   |
| `usedIniframe`      | number         | Embedded-client usage flag; currently `0`.                              |

When `chainId` is omitted, `data` contains one group for every supported chain in router configuration order, including groups whose `tokens` array is empty. When `chainId` is provided, `data` is still an array and contains exactly one chain group.

The tokens returned by this endpoint are mainstream tokens on each blockchain, not an exhaustive list of tokens supported by the Butter Router service. The Butter Router service theoretically supports all tokens, including tokens not returned by this endpoint. When Solana is the destination chain, all destination tokens are supported except Token-2022 tokens.

### Response Examples

> 200 Response

```json
{
  "errno": 0,
  "message": "success",
  "data": [
    {
      "chainId": 1,
      "tokens": [
        {
          "id": 1,
          "chainId": 1,
          "address": "0x0000000000000000000000000000000000000000",
          "blockchainNetwork": "1",
          "coingeckoId": "",
          "decimals": 18,
          "image": "https://files.mapprotocol.io/bridge/butter64_64.png",
          "name": "Ether",
          "rank": 0,
          "symbol": "ETH",
          "tokenSecurity": null,
          "usdprice": 0,
          "usedIniframe": 0
        }
      ]
    }
  ]
}
```

An unsupported or unrecognized `chainId` returns an application error with HTTP status 200:

```json
{
  "errno": 2001,
  "message": "The Chain not Support"
}
```

Use [`GET /supportedChainInfo`](/butter-swap-integration/butter-api-for-routing/get-supportedchaininfo.md) to discover the current supported chain IDs. Token and chain configuration may change over time, so query this endpoint instead of maintaining a static list.

**Please find all** [**ButterSwap API Reference**](https://bs-router-v3.chainservice.io/docs#/) **here.**