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, an execution-ready calldata payload, and optional non-blocking warnings. 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.
senderAddress is required. receiverAddress is optional only when the origin and destination chain types match; otherwise it must be provided explicitly.
Address validation is chain-specific: senderAddress is validated against the origin chain type, and receiverAddress is validated against the destination chain type. Invalid or incompatible addresses return 400 Bad Request.

​
Address Behavior

Route typesenderAddressreceiverAddress
Same chain type (EVM -> EVM, SVM -> SVM)RequiredOptional. Defaults to senderAddress if omitted.
Different chain types (EVM -> SVM, SVM -> EVM)RequiredRequired
Example: 
GET /v1/quotes?originChainId=1&destinationChainId=42161&originCurrency=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&destinationCurrency=0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8&senderAddress=0xYourSenderAddr&amount=1000000
This is valid because the route stays within the same chain type (EVM -> EVM), so receiverAddress can default to senderAddress. 
GET /v1/quotes?originChainId=1&destinationChainId=1000000001&originCurrency=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&destinationCurrency=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&senderAddress=0xYourSenderAddr&amount=1000000
This returns 400 Bad Request because the route is EVM -> SVM, so receiverAddress must be provided explicitly. 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. Required for quote generation and execution payload construction. It is validated against the origin chain type.

​
receiverAddress
string

The receiving wallet address. It is validated against the destination chain type. If omitted and the origin/destination chain types match, senderAddress will be used. If the chain types differ, receiverAddress is required.

​
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:

"OPENOCEAN"

"OPENOCEAN,OKX"

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

​
adapter
string
required

The adapter or route selected for the transaction

​
calldata
object
required

Execution-ready transaction payload returned by Delora

​
fees
object

Structured fee summary, including the dominant total currency and raw fee breakdown

​
gas
object

Suggested gas values for EVM execution when available

​
warnings
object[]

Optional non-blocking warnings returned with the quote