List Tokens

Returns tokens supported by the Value Transfer API. Use query parameters to filter for tokens transferrable from a specific source chain and token.

Reference

Parameters

Parameter	Type	Required	Description
`transferrableFromChainKey`	string	No	Source chain key (for example, `base`, `ethereum`). Must be combined with `transferrableFromTokenAddress`.
`transferrableFromTokenAddress`	string	No	Source token address. Must be combined with `transferrableFromChainKey`.
`pagination[nextToken]`	string	No	Pagination cursor from previous response

Validate transfer routes Provide both transferrableFromChainKey and transferrableFromTokenAddress to get only destination tokens you can transfer to.

Response

Returns a tokens array and a pagination object.

Attributes

Attribute	Type	Description
`isSupported`	boolean	Whether the token is available for transfers
`chainKey`	string	Chain identifier (for example, `ethereum`, `base`)
`address`	string	Token contract address
`decimals`	number	Token decimal places
`symbol`	string	Token symbol (for example, `ETH`, `USDC`)
`name`	string	Full token name
`logoUrl`	string	Optional token logo URL
`price`	object	Optional price information
`price.usd`	number	Current price in USD

Code examples

List all tokens

Returns the complete token catalog across all chains.

cURL
TypeScript
Python

curl -X GET "https://transfer.layerzero-api.com/v1/tokens"

const response = await fetch('https://transfer.layerzero-api.com/v1/tokens');
const {tokens} = await response.json();

console.log(tokens);

import requests

response = requests.get("https://transfer.layerzero-api.com/v1/tokens")
tokens = response.json()["tokens"]

print(tokens)

List transferrable destinations

Returns only tokens you can transfer to from a specific source.

cURL
TypeScript
Python

curl -X GET "https://transfer.layerzero-api.com/v1/tokens?transferrableFromChainKey=base&transferrableFromTokenAddress=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"

const params = new URLSearchParams({
  transferrableFromChainKey: 'base',
  transferrableFromTokenAddress: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE',
});

const response = await fetch(`https://transfer.layerzero-api.com/v1/tokens?${params}`);
const {tokens} = await response.json();

console.log(tokens);

import requests

response = requests.get(
  "https://transfer.layerzero-api.com/v1/tokens",
  params={
    "transferrableFromChainKey": "base",
    "transferrableFromTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
  },
)
tokens = response.json()["tokens"]

print(tokens)

Response

{
  "tokens": [
    {
      "isSupported": true,
      "chainKey": "base",
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "symbol": "USDC",
      "name": "USD Coin",
      "price": {
        "usd": 0.99986254
      }
    },
    {
      "isSupported": true,
      "chainKey": "base",
      "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "decimals": 18,
      "symbol": "ETH",
      "name": "Ether",
      "price": {
        "usd": 2132.3224
      }
    },
    {
      "isSupported": true,
      "chainKey": "ethereum",
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "decimals": 6,
      "symbol": "USDC",
      "name": "USDC",
      "price": {
        "usd": 0.99986254
      }
    },
    {
      "isSupported": true,
      "chainKey": "ethereum",
      "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "decimals": 18,
      "symbol": "ETH",
      "name": "ETH",
      "price": {
        "usd": 2132.3224
      }
    },
    {
      "isSupported": true,
      "chainKey": "arbitrum",
      "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "decimals": 6,
      "symbol": "USDC",
      "name": "USD Coin",
      "price": {
        "usd": 0.99986254
      }
    }
  ],
  "pagination": {}
}

Validate transfer routes

Check if a transfer route exists before requesting quotes:

async function validatePath(
  srcChain: string,
  srcToken: string,
  dstChain: string,
  dstToken: string,
): Promise<boolean> {
  const params = new URLSearchParams({
    transferrableFromChainKey: srcChain,
    transferrableFromTokenAddress: srcToken,
  });

  const response = await fetch(`https://transfer.layerzero-api.com/v1/tokens?${params}`);
  const {tokens} = await response.json();

  return tokens.some(
    (t) => t.chainKey === dstChain && t.address.toLowerCase() === dstToken.toLowerCase(),
  );
}

const isSupported = await validatePath(
  'base',
  '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
  'arbitrum',
  '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
);

Chains — List supported blockchain networks
Quotes — Request transfer quotes for validated routes

Query Parameters

transferrableFromChainKey

string

Filter tokens by source chain (for example, 'ethereum', 'arbitrum')

Example:

"ethereum"

transferrableFromTokenAddress

string

Filter by source token address

Example:

"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"

Response

200 - application/json

Successfully retrieved token list

tokens

object[]

Show child attributes

pagination

object

Show child attributes

Value Transfer API

Contracts

API Reference

Examples

Reference

Parameters

Response

Attributes

Code examples

List all tokens

List transferrable destinations

Response

Validate transfer routes

Query Parameters

Response

Value Transfer API

Contracts

API Reference

Examples

​Reference

​Parameters

​Response

​Attributes

​Code examples

​List all tokens

​List transferrable destinations

​Response

​Validate transfer routes

​Related endpoints

Query Parameters

Response

Reference

Parameters

Response

Attributes

Code examples

List all tokens

List transferrable destinations

Response

Validate transfer routes

Related endpoints