Skip to main content
GET
/
v1
/
quotes
Get a quote for a token transfer
curl --request GET \
  --url https://api.delora.build/v1/quotes
{
  "inputAmount": "1000000",
  "outputAmount": "998400",
  "adapter": "RELAY",
  "calldata": {
    "to": "0xRouterContract",
    "data": "0xabcdef...",
    "value": "0"
  },
  "fees": {
    "total": {
      "amount": "534942",
      "currencySymbol": "USDC",
      "currencyAddress": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
      "chainId": 42161,
      "decimals": 6
    },
    "breakdown": [
      {
        "type": "gas",
        "amount": "494502800000",
        "currencySymbol": "ETH",
        "currencyAddress": "0x0000000000000000000000000000000000000000",
        "chainId": 42161,
        "decimals": 18,
        "amountUsd": "0.001475"
      },
      {
        "type": "relayer",
        "amount": "267471",
        "currencySymbol": "USDC",
        "currencyAddress": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
        "chainId": 42161,
        "decimals": 6,
        "amountUsd": "0.267404"
      }
    ],
    "totalUsd": "0.536283"
  },
  "gas": {
    "gasPrice": "0x018e2d98"
  }
}
This endpoint enables you to request a quote for transferring tokens, whether across chains or within the same chain. It returns detailed information, including an estimated output amount and a “calldata” that can be directly submitted to your wallet. The estimated output amount can be found in the outputAmount field.
All Delora APIs don’t require an API key by default. An API key is only necessary for accessing higher request limits.
Base URL: https://api.delora.build/v1

Query Parameters

​
originChainId
number
required

The sending chain id

​
destinationChainId
number
required

The receiving chain id

​
originCurrency
string
required

The token address that should be transferred

​
destinationCurrency
string
required

The token address that should be transferred to

​
senderAddress
string
required

The sending wallet address

​
receiverAddress
string

The receiving wallet address. If none is provided, the senderAddress will be used

​
amount
string
required

The amount that should be sent including all decimals (e.g. 1000000 for 1 USDC with 6 decimals)

​
integrator
string

A string containing tracking information about the integrator of the API

​
fee
string

An optional fee applied to the transaction, expressed as a decimal value. Supported range is from 0 to 0.1 (0 – 10%). If this parameter is not specified, no fees are collected.

​
slippage
number

Specifies the maximum permissible slippage for a transaction, expressed as a decimal value. For example, 0.005 corresponds to a slippage of 0.5%. Allowed range: 0 ≤ x ≤ 1

​
excludeBridges
string

List of bridge adapters that should be excluded from the /quotes. Bridge tool identifiers must be provided as a comma-separated list. Retrieve current bridge keys from the /v1/tools endpoint.

Examples:

"relay"

"relay, mayan"

​
excludeExchanges
string

List of exchange adapters that should be excluded from the /quotes. Exchange tool identifiers must be provided as a comma-separated list. Retrieve current exchange keys from the /v1/tools endpoint.

Examples:

"jupiter"

"okx, across"

Response

Quote response

​
inputAmount
string
required

The amount that should be transferred including all decimals

​
outputAmount
string
required

The estimated resulting amount of the destinationCurrency including all decimals

​
tool
string
required

The tool used for the transaction

​
calldata
object[]
required

The transaction data that can be triggered using a wallet provider

​
fees
object[]

Fees included in the transfer

​
gas
object[]

Gas included in the transfer