Get a quote for a token transfer

Returns the best available route for an exact-input transfer or swap, including estimated output, executable calldata, fee breakdown, optional gas data, and non-blocking warnings.

GET /v1/quotes

Get the best executable quote

cURL

curl --request GET \
  --url https://api.delora.build/v1/quotes

200

{
  "inputAmount": "1000000",
  "outputAmount": "997321",
  "minOutputAmount": "992334",
  "adapter": "OPENOCEAN",
  "calldata": {
    "to": "0x1111111111111111111111111111111111111111",
    "value": "0x0",
    "data": "0xabcdef"
  },
  "fees": {
    "total": {
      "amount": "2679",
      "currencySymbol": "USDC",
      "currencyAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "chainId": 8453,
      "decimals": 6
    },
    "breakdown": [
      {
        "type": "gas",
        "amount": "2679",
        "currencySymbol": "USDC",
        "currencyAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "chainId": 8453,
        "decimals": 6,
        "amountUsd": "0.01"
      }
    ],
    "totalUsd": "0.01"
  },
  "gas": {
    "gasPrice": "0x3b9aca00",
    "maxFeePerGas": "0x59682f00",
    "maxPriorityFeePerGas": "0x3b9aca00"
  },
  "warnings": [
    {
      "code": "SOLANA_INSUFFICIENT_BALANCE",
      "message": "Solana simulation reported insufficient balance."
    }
  ]
}

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 type	senderAddress	receiverAddress
Same chain type (EVM -> EVM, SVM -> SVM)	Required	Optional. Defaults to senderAddress if omitted.
Different chain types (EVM -> SVM, SVM -> EVM)	Required	Required

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

Headers

x-api-key · string

Optional API key for higher rate limits and fee rules.

Query Parameters

senderAddress · string · required

Sender wallet address on the origin chain.

Example:

"0x1111111111111111111111111111111111111111"

receiverAddress · string

Receiver wallet address. Required when EVM and Solana are crossed.

Example:

"0x2222222222222222222222222222222222222222"

originChainId · number · required

Origin chain ID.

Example:

8453

destinationChainId · number · required

Destination chain ID.

Example:

8453

amount · string · required

Input amount in token base units as a positive integer string.

Example:

"1000000"

originCurrency · string · required

Origin token address, or native asset marker supported by the backend.

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

destinationCurrency · string · required

Destination token address, or native asset marker supported by the backend.

Example:

"0x4200000000000000000000000000000000000006"

integrator · string

Integrator identifier. Required when fee is provided.

Example:

"partner-app"

fee · number

Optional integrator fee fraction. 0.01 means 1%.

Required range: 0 <= x <= 0.1

Example:

0.01

slippage · number

Optional slippage fraction. 0.005 means 0.5%.

Required range: 0 <= x <= 1

Example:

0.005

excludeBridges · string

Comma-separated bridge adapter names to exclude, for example RELAY,ACROSS.

Example:

"RELAY,ACROSS"

excludeExchanges · string

Comma-separated exchange adapter names to exclude, for example OPENOCEAN,OKX.

Example:

"OPENOCEAN,OKX"

Response

200

application/json

Best executable quote response.

inputAmount · string · required

Example:

"1000000"

outputAmount · string · required

Example:

"997321"

adapter · enum<string> · required

Available options: ACROSS, RELAY, GASZIP, OPENOCEAN, JUPITER, SYMBIOSIS, MAYAN, MAYAN_WORMHOLE, MAYAN_SWIFT, MAYAN_MCTP, MAYAN_FAST_MCTP, OKX, RISE, NORDSTERN

Example:

"OPENOCEAN"

calldata · object · required

Show child attributes

fees · object · required

Show child attributes

minOutputAmount · string

Example:

"992334"

gas · object

Show child attributes

warnings · object[]

Show child attributes