Request Quotes - LayerZero

Get transfer quotes

curl --request POST \
  --url https://transfer.layerzero-api.com/v1/quotes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "srcChainKey": "base",
  "dstChainKey": "optimism",
  "srcTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
  "dstTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
  "srcWalletAddress": "0x1234567890123456789012345678901234567890",
  "dstWalletAddress": "0x1234567890123456789012345678901234567890",
  "amount": "100000000000000000"
}
'

{
  "quotes": [
    {
      "id": "quote_abc123",
      "feeUsd": "0.50",
      "feePercent": "0.5",
      "srcAmount": "100000000000000000",
      "dstAmount": "99500000000000000",
      "routeSteps": [
        {
          "type": "STARGATE_V2_TAXI",
          "srcChainKey": "base"
        }
      ],
      "userSteps": [
        {
          "type": "TRANSACTION",
          "chainKey": "base",
          "chainType": "EVM"
        }
      ]
    }
  ],
  "tokens": []
}

POST

quotes

Get transfer quotes

curl --request POST \
  --url https://transfer.layerzero-api.com/v1/quotes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "srcChainKey": "base",
  "dstChainKey": "optimism",
  "srcTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
  "dstTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
  "srcWalletAddress": "0x1234567890123456789012345678901234567890",
  "dstWalletAddress": "0x1234567890123456789012345678901234567890",
  "amount": "100000000000000000"
}
'

{
  "quotes": [
    {
      "id": "quote_abc123",
      "feeUsd": "0.50",
      "feePercent": "0.5",
      "srcAmount": "100000000000000000",
      "dstAmount": "99500000000000000",
      "routeSteps": [
        {
          "type": "STARGATE_V2_TAXI",
          "srcChainKey": "base"
        }
      ],
      "userSteps": [
        {
          "type": "TRANSACTION",
          "chainKey": "base",
          "chainType": "EVM"
        }
      ]
    }
  ],
  "tokens": []
}

Returns one or more quotes for cross-chain transfers, each with fee breakdowns, estimated duration, and execution steps.

Reference

Request body

Parameter	Type	Required	Description
`amount`	string	Yes	Amount in smallest units (wei for ETH, lamports for SOL)
`srcChainKey`	string	Yes	Source chain identifier (for example, `base`, `ethereum`)
`srcTokenAddress`	string	Yes	Source token contract address
`srcWalletAddress`	string	Yes	Sender wallet address
`dstChainKey`	string	Yes	Destination chain identifier
`dstTokenAddress`	string	Yes	Destination token contract address
`dstWalletAddress`	string	Yes	Recipient wallet address
`options`	object	No	Optional transfer configuration
`options.amountType`	enum	No	`EXACT_SRC_AMOUNT` (default)
`options.feeTolerance`	object	No	Maximum acceptable fee variance
`options.feeTolerance.type`	string	No	`PERCENT`
`options.feeTolerance.amount`	number	No	Tolerance percentage (0-100). Default: `1`
`options.dstNativeDropAmount`	string	No	Native gas drop on destination. Default: `0`

Response

Returns a quotes array, rejectedQuotes array, and tokens array.

Quote attributes

Attribute	Type	Description
`id`	string	Unique quote identifier (becomes transfer ID after execution)
`routeSteps`	array	Array of route segments with protocol types
`fees`	array	Detailed fee breakdown by chain and type
`duration`	object	Estimated transfer duration
`duration.estimated`	string or null	Duration in milliseconds (null if unknown)
`feeUsd`	string	Total fees in USD
`feePercent`	string	Fee as percentage of transfer amount
`srcAmount`	string	Exact amount leaving source chain
`dstAmount`	string	Expected amount on destination chain
`dstAmountMin`	string	Minimum guaranteed amount (with slippage protection)
`srcAmountUsd`	string	Source amount in USD
`dstAmountUsd`	string	Destination amount in USD
`userSteps`	array	Actions to execute (transactions or signatures)
`options`	object	Transfer options
`options.dstNativeDropAmount`	string	Native gas drop configuration
`expiresAt`	string	Quote expiration timestamp (may not be present on all quotes)

Route step attributes

Attribute	Type	Description
`type`	enum	Route protocol (see Route types)
`srcChainKey`	string	Chain where this step executes
`description`	string	Human-readable step description

Fee attributes

Attribute	Type	Description
`chainKey`	string	Chain where fee is paid
`type`	enum	`MESSAGE`, `GENERAL`, `DST_NATIVE_DROP`, `CCTP_RECEIVE`
`description`	string	Human-readable fee description
`amount`	string	Fee amount in token units
`address`	string	Token address for fee

User step types

User steps can be TRANSACTION or SIGNATURE: TRANSACTION step:

{
  type: "TRANSACTION",
  description: string,
  chainKey: string,
  chainType: "EVM" | "SOLANA" | "STARKNET",
  signerAddress: string,
  transaction: {
    encoded: {
      to: string,
      data: string,
      value?: string,
      chainId: number,
      from?: string,
      gasLimit?: string
    }
  }
}

SIGNATURE step (EIP-712 for Aori routes):

{
  type: "SIGNATURE",
  description: string,
  chainKey: string,
  signerAddress: string,
  signature: {
    type: "EIP712",
    typedData: {
      domain: object,
      types: object,
      message: object
    }
  }
}

Executing userSteps safely

For ERC20 token transfers, the API returns two user steps with different to addresses:

Step	`transaction.encoded.to`	Purpose
Approve	ERC20 token contract (e.g., USDC)	Calls `approve(TransferDelegate, amount)`. The TransferDelegate address is encoded inside the `data` field.
Bridge	LZMulticall contract	Routes the bridge transaction through LayerZero’s feeWrapper.

Never approve the LZMulticall (Wrapper) as a token spenderLZMulticall executes bridge transactions. It is not the right spender, and approving it will lose you tokens. The correct spender is the TransferDelegate, and the API’s approve step already has this set in the calldata. Execute every userStep as returned.See Contracts Overview for details on the contract architecture.

Route types

The API evaluates multiple protocols and returns the best routes:

Type	Description
`OFT`	OFT Standard transfers
`STARGATE_V2_TAXI`	Stargate V2 instant transfers
`STARGATE_V2_BUS`	Stargate V2 batched transfers
`CCTP`	Circle CCTP for native USDC
`AORI`	Intent-based swaps via Aori

Code examples

EVM transfer

cURL
TypeScript
Python

curl -X POST "https://transfer.layerzero-api.com/v1/quotes" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "srcChainKey": "base",
    "dstChainKey": "arbitrum",
    "srcTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "dstTokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "srcWalletAddress": "0x1234567890123456789012345678901234567890",
    "dstWalletAddress": "0x1234567890123456789012345678901234567890",
    "amount": "1000000"
  }'

const response = await fetch('https://transfer.layerzero-api.com/v1/quotes', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    srcChainKey: 'base',
    dstChainKey: 'arbitrum',
    srcTokenAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
    dstTokenAddress: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
    srcWalletAddress: '0x1234567890123456789012345678901234567890',
    dstWalletAddress: '0x1234567890123456789012345678901234567890',
    amount: '1000000',
  }),
});

const {quotes} = await response.json();
console.log('Quote ID:', quotes[0].id);
console.log('Fee:', quotes[0].feeUsd, 'USD');

import requests

response = requests.post(
  "https://transfer.layerzero-api.com/v1/quotes",
  headers={"x-api-key": "YOUR_API_KEY"},
  json={
    "srcChainKey": "base",
    "dstChainKey": "arbitrum",
    "srcTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "dstTokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "srcWalletAddress": "0x1234567890123456789012345678901234567890",
    "dstWalletAddress": "0x1234567890123456789012345678901234567890",
    "amount": "1000000",
  },
)

quote = response.json()["quotes"][0]
print(f"Quote ID: {quote['id']}")
print(f"Fee: {quote.get('feeUsd', 'N/A')} USD")

Response

{
  "error": null,
  "quotes": [
    {
      "id": "0x00000000000000000000000000000000019c43bf3589735e9c7299af4c6f5971",
      "routeSteps": [
        {
          "type": "STARGATE_V2_TAXI",
          "srcChainKey": "base",
          "description": "Stargate"
        }
      ],
      "fees": [
        {
          "chainKey": "base",
          "type": "MESSAGE",
          "description": "",
          "amount": "45604559761712",
          "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"
        }
      ],
      "duration": {
        "estimated": "27600"
      },
      "feeUsd": "0.00033795",
      "feePercent": "0.00033800",
      "srcAmount": "1000000",
      "dstAmount": "999662",
      "dstAmountMin": "990000",
      "srcAmountUsd": "0.99986254",
      "dstAmountUsd": "0.99952459",
      "userSteps": [
        {
          "type": "TRANSACTION",
          "description": "approve",
          "chainKey": "base",
          "chainType": "EVM",
          "signerAddress": "0x1234567890123456789012345678901234567890",
          "transaction": {
            "encoded": {
              "chainId": 8453,
              "data": "0x095ea7b300000000000000000000000027a16dc786820b16e5c9028b75b99f6f604b5d2600000000000000000000000000000000000000000000000000000000000f4240",
              "from": "0x1234567890123456789012345678901234567890",
              "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
            }
          }
        },
        {
          "type": "TRANSACTION",
          "description": "bridge",
          "chainKey": "base",
          "chainType": "EVM",
          "signerAddress": "0x1234567890123456789012345678901234567890",
          "transaction": {
            "encoded": {
              "chainId": 8453,
              "data": "0xc7c7f5b3...",
              "from": "0x1234567890123456789012345678901234567890",
              "to": "0x27a16dc786820B16E5c9028b75B99F6f604b5d26",
              "value": "45604559761712"
            }
          }
        }
      ],
      "options": {
        "dstNativeDropAmount": "0"
      }
    }
  ],
  "rejectedQuotes": [],
  "tokens": [
    {
      "chainKey": "base",
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "symbol": "USDC",
      "name": "USD Coin",
      "price": {
        "usd": 0.99986254
      }
    },
    {
      "chainKey": "arbitrum",
      "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "decimals": 6,
      "symbol": "USDC",
      "name": "USD Coin",
      "price": {
        "usd": 0.99986254
      }
    },
    {
      "chainKey": "base",
      "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "decimals": 18,
      "symbol": "ETH",
      "name": "Ether",
      "price": {
        "usd": 2132.32235403
      }
    },
    {
      "chainKey": "arbitrum",
      "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "decimals": 18,
      "symbol": "ETH",
      "name": "ETH",
      "price": {
        "usd": 2132.32235403
      }
    }
  ]
}

Errors

The API returns an error object when the request fails:

{
  "error": {
    "status": 4000,
    "message": "Invalid input",
    "issues": [
      {
        "message": "Invalid source token"
      }
    ]
  },
  "quotes": []
}

Check the error field before processing quotes:

const result = await response.json();

if (result.error) {
  console.error('Quote error:', result.error.message);
  result.error.issues?.forEach((issue) => {
    console.error('  -', issue.message);
  });
  return;
}

Quote expiration

Quotes may include an expiresAt timestamp. Execute quotes promptly or request a new quote if expired.

const quote = quotes[0];

if (quote.expiresAt) {
  const expiresAt = new Date(quote.expiresAt);
  if (new Date() > expiresAt) {
    console.log('Quote expired, request a new one');
  }
}

Build user steps — Generate fresh transaction data for Solana transfers
Submit signature — Submit EIP-712 signatures for intent-based routes
Status — Track transfer progress after execution

Examples

EVM Example — Complete transfer with viem
Solana Example — Complete Solana transfer

Authorizations

x-api-key

string

header

required

API key for authenticating requests. Required for /quotes, /build-user-steps, /submit-signature, and /status endpoints.

Body

application/json

srcChainKey

string

required

Source chain key (for example, 'base', 'arbitrum')

Example:

"base"

dstChainKey

string

required

Destination chain key

Example:

"optimism"

srcTokenAddress

string

required

Source token address (use 0xEeee...EEeE for native ETH)

Example:

"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"

dstTokenAddress

string

required

Destination token address

Example:

"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"

srcWalletAddress

string

required

Sender wallet address

Example:

"0x1234567890123456789012345678901234567890"

dstWalletAddress

string

required

Recipient wallet address

Example:

"0x1234567890123456789012345678901234567890"

amount

string

required

Transfer amount in smallest units (wei for ETH)

Example:

"100000000000000000"

Response

200 - application/json

Successfully retrieved quotes

quotes

object[]

Show child attributes

tokens

object[]

Metadata Build User Steps

⌘I

Documentation Index

​Reference

​Request body

​Response

​Quote attributes

​Route step attributes

​Fee attributes

​User step types

​Executing userSteps safely

​Route types

​Code examples

​EVM transfer

​Response

​Errors

​Quote expiration

​Related endpoints

​Examples

Authorizations

Body

Response

Reference

Request body

Response

Quote attributes

Route step attributes

Fee attributes

User step types

Executing userSteps safely

Route types

Code examples

EVM transfer

Response

Errors

Quote expiration

Related endpoints

Examples