Skip to main content
GET
Get the best executable quote
Request an exact-input quote for a same-chain swap or cross-chain transfer. The response includes estimated output amounts, executable calldata, fees, and optional non-blocking warnings.

Automatic slippage

Set slippageMode=auto to use Delora’s route-specific automatic slippage policy. When it is supplied, it takes precedence over a numeric slippage value.

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. Defaults to senderAddress for same chain-type routes (EVM -> EVM or SVM -> SVM) and is required when crossing chain types (EVM -> SVM or SVM -> EVM).

Example:

"0x2222222222222222222222222222222222222222"

originChainId
number
required

Origin chain ID.

Example:

8453

destinationChainId
number
required

Destination chain ID.

Example:

8453

amount
string
required

Exact input amount in token base units as a positive integer string, before Delora and integrator fees.

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 used for fee attribution. Required when fee is provided.

Example:

"partner-app"

fee
number

Optional integrator fee fraction taken from the input amount. 0.01 means 1%. Must be between 0 and 0.1 inclusive and can be provided only with integrator.

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

slippageMode
enum<string>

Automatic slippage policy. Set to auto to let Delora choose the route-specific slippage; when supplied, it takes precedence over slippage.

Available options:
auto
Example:

"auto"

includeBridges
string

Comma-separated bridge adapter keys from /v1/tools to include, for example RELAY,ACROSS. Only bridge-capable or multi-capability adapters are valid.

Example:

"RELAY,ACROSS"

includeExchanges
string

Comma-separated exchange adapter keys from /v1/tools to include, for example OPENOCEAN,OKX. Only exchange-capable or multi-capability adapters are valid.

Example:

"OPENOCEAN,OKX"

excludeBridges
string

Comma-separated bridge adapter keys from /v1/tools to exclude, for example RELAY,ACROSS. Only bridge-capable or multi-capability adapters are valid.

Example:

"RELAY,ACROSS"

excludeExchanges
string

Comma-separated exchange adapter keys from /v1/tools to exclude, for example OPENOCEAN,OKX. Only exchange-capable or multi-capability adapters are valid.

Example:

"OPENOCEAN,OKX"

Response

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,
KYBERSWAP,
DFLOW,
NEAR_INTENTS
Example:

"OPENOCEAN"

calldata
object
required
fees
object
required
minOutputAmount
string
Example:

"992334"

estimatedTimeSec
number

Estimated bridge completion time in seconds. Returned only for bridge routes.

Example:

120

gas
object
warnings
object[]
approvalAddress
string

Approval spender address for EVM-origin routes.

Example:

"0x1111111111111111111111111111111111111111"

transactionSize
object

Serialized Solana transaction size when available.

bridgeScan
object

Bridge tracking metadata returned when the selected bridge adapter provides it.

simulation
object

Best-effort transaction simulation metadata returned when simulation is enabled for the selected route.

usd
object

Cached USD price snapshots for the origin and destination quote tokens.