v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB
tokens

List Supported Tokens with Metadata

Beta <br/> Retrieves a list of tokens along with their metadata, such as the token's name, symbol, decimals, logo URI, and associated tags. This information is useful for displaying token details and allowing users to search or filter tokens based on specific criteria. Tags can be used to narrow down the returned tokens. Example: Use the tag stablecoins to only return stablecoin tokens.

💡 Compute Unit Value: 60 (fixed)

get/tokens/v1

Query parameters

chainIDstring

The unique identifier of a blockchain in CAIP-2 notation. Find more here.

Example:eip155:1

The CAIP-2 identifier for a blockchain. Find more here.

tokenAddressstring

The address of an account.

Example:0xf271AAFC62634e6Dc9A276ac0f6145C4fDbE2Ced

The address of an token contract to query. If omitted, all supported tokens will be queried.

tokenSymbolstring

The symbol of a token.

The symbol of an token contract.

tagLimitstring[]

A list of token tag identifiers to include in the query.

[
  "stablecoin",
  "defi"
]

Response

Successful response containing a list of tokens with their metadata, such as name, symbol, decimals, logo URI, tags, and associated chains.

object required

A collection of supported tokens grouped by chain ID.

Example response

{
  "eip155:1": [
    {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "chainID": "eip155:1",
      "decimals": 6,
      "extensions": {
        "homepage": "https://www.circle.com/en/usdc",
        "verified": true
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/1-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.webp",
      "name": "USDC",
      "priceUSD": 1,
      "symbol": "USDC",
      "tags": [
        "stargateV2",
        "stargateV1",
        "stablecoin"
      ]
    }
  ],
  "eip155:10": [
    {
      "address": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
      "chainID": "eip155:10",
      "decimals": 6,
      "extensions": {
        "homepage": "https://www.circle.com/en/usdc",
        "verified": true
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/10-0x0b2c639c533813f4aa9d7837caf62653d097ff85.webp",
      "name": "USDC",
      "priceUSD": 1,
      "symbol": "USDC",
      "tags": [
        "stargateV2",
        "stablecoin"
      ]
    }
  ],
  "eip155:1313161554": [
    {
      "address": "0x368EBb46ACa6b8D0787C96B2b20bD3CC3F2c45F7",
      "chainID": "eip155:1313161554",
      "decimals": 6,
      "extensions": {
        "verified": false
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/1313161554-0x368ebb46aca6b8d0787c96b2b20bd3cc3f2c45f7.webp",
      "name": "USDC (Bridged)",
      "symbol": "USDC",
      "tags": [
        "stablecoin",
        "stargateV2"
      ]
    }
  ],
  "eip155:137": [
    {
      "address": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
      "chainID": "eip155:137",
      "decimals": 6,
      "extensions": {
        "homepage": "https://www.circle.com/en/usdc",
        "verified": true
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/137-0x3c499c542cef5e3811e1192ce70d8cc03d5c3359.webp",
      "name": "USDC",
      "priceUSD": 1,
      "symbol": "USDC",
      "tags": [
        "stargateV2",
        "stablecoin"
      ]
    }
  ],
  "eip155:250": [
    {
      "address": "0x28a92dde19D9989F39A49905d7C9C2FAc7799bDf",
      "chainID": "eip155:250",
      "decimals": 6,
      "extensions": {
        "verified": false
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/250-0x28a92dde19d9989f39a49905d7c9c2fac7799bdf.webp",
      "name": "USDC (Bridged)",
      "priceUSD": 1.003,
      "symbol": "USDC",
      "tags": [
        "stargateV1",
        "stablecoin"
      ]
    }
  ],
  "eip155:42161": [
    {
      "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "chainID": "eip155:42161",
      "decimals": 6,
      "extensions": {
        "homepage": "https://www.circle.com/en/usdc",
        "verified": true
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/42161-0xaf88d065e77c8cc2239327c5edb3a432268e5831.webp",
      "name": "USDC",
      "priceUSD": 1,
      "symbol": "USDC",
      "tags": [
        "stargateV2",
        "stablecoin"
      ]
    }
  ],
  "eip155:42220": [
    {
      "address": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
      "chainID": "eip155:42220",
      "decimals": 25,
      "extensions": {
        "homepage": "https://www.circle.com/en/usdc",
        "verified": true
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/42220-0xceba9300f2b948710d2653dd7b07f33a8b32118c.webp",
      "name": "USDC",
      "priceUSD": 1,
      "symbol": "USDC",
      "tags": [
        "stablecoin"
      ]
    }
  ],
  "eip155:43114": [
    {
      "address": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
      "chainID": "eip155:43114",
      "decimals": 6,
      "extensions": {
        "homepage": "https://www.circle.com/en/usdc",
        "verified": true
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/43114-0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e.webp",
      "name": "USDC",
      "priceUSD": 1,
      "symbol": "USDC",
      "tags": [
        "stargateV2",
        "stargateV1",
        "stablecoin"
      ]
    }
  ],
  "eip155:5000": [
    {
      "address": "0x09bc4e0d864854c6afb6eb9a9cdf58ac190d0df9",
      "chainID": "eip155:5000",
      "decimals": 6,
      "extensions": {
        "homepage": "",
        "verified": false
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/5000-0x09bc4e0d864854c6afb6eb9a9cdf58ac190d0df9.webp",
      "name": "USDC (Bridged)",
      "priceUSD": 1.003,
      "symbol": "USDC",
      "tags": [
        "stargateV2",
        "stablecoin"
      ]
    }
  ],
  "eip155:8453": [
    {
      "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "chainID": "eip155:8453",
      "decimals": 6,
      "extensions": {
        "homepage": "https://www.circle.com/en/usdc",
        "verified": true
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/8453-0x833589fcd6edb6e08f4c7c32d4f71b54bda02913.webp",
      "name": "USDC",
      "priceUSD": 1,
      "symbol": "USDC",
      "tags": [
        "stargateV2",
        "stablecoin"
      ]
    }
  ]
}