---
title: "Get the best executable quote"
method: GET
path: "/v1/quotes"
tags: ["V1"]
---

# Get the best executable quote

`GET /v1/quotes`

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.

## Query parameters

- `senderAddress` string, required
- `receiverAddress` string
- `originChainId` number, required
- `destinationChainId` number, required
- `amount` string, required
- `originCurrency` string, required
- `destinationCurrency` string, required
- `integrator` string
- `fee` number
- `slippage` number
- `includeBridges` string
- `includeExchanges` string
- `excludeBridges` string
- `excludeExchanges` string

## Headers

- `x-api-key` string

## Response `200`

Best executable quote response.

- QuoteResponseDto
  - `inputAmount` string, required
  - `outputAmount` string, required
  - `minOutputAmount` string
  - `estimatedTimeSec` number — Estimated bridge completion time in seconds. Returned only for bridge routes.
  - `adapter` 'ACROSS' | 'RELAY' | 'GASZIP' | 'OPENOCEAN' | 'JUPITER' | 'SYMBIOSIS' | 'MAYAN' | 'MAYAN_WORMHOLE' | 'MAYAN_SWIFT' | 'MAYAN_MCTP' | 'MAYAN_FAST_MCTP' | 'OKX' | 'RISE' | 'NORDSTERN' | 'KYBERSWAP' | 'DFLOW' | 'NEAR_INTENTS', required
  - `calldata` QuoteCalldataDto, required
    - `to` string, required
    - `value` string, required
    - `data` string, required
  - `fees` ParsedFeesDto, required
    - `total` ParsedFeesTotalCurrencyDto, required
      - `amount` string, required
      - `currencySymbol` string, required
      - `currencyAddress` string, required
      - `chainId` number, required
      - `decimals` number
    - `breakdown` ParsedFeesBreakdownItemDto[], required
      - `amount` string, required
      - `currencySymbol` string, required
      - `currencyAddress` string, required
      - `chainId` number, required
      - `decimals` number
      - `type` 'gas' | 'relayer' | 'relayerGas' | 'relayerService' | 'capital' | 'lp' | 'app' | 'total', required
      - `amountUsd` string
    - `totalUsd` string
  - `gas` GasEstimationDto
    - `gasPrice` string
    - `maxFeePerGas` string
    - `maxPriorityFeePerGas` string
  - `warnings` QuoteWarningDto[]
    - `code` 'INTEGRATOR_SOLANA_WALLET_NOT_ACTIVATED_FEE_SKIPPED' | 'INTEGRATOR_WALLET_NOT_CONFIGURED_FEE_SKIPPED' | 'SOLANA_SYSTEM_ACCOUNT_SKIPPED' | 'SOLANA_INSUFFICIENT_BALANCE' | 'SOLANA_SIMULATION_FAILED', required
    - `message` string, required
  - `approvalAddress` string — Approval spender address for EVM-origin routes.
  - `transactionSize` object — Serialized Solana transaction size when available.
    - `raw` number
    - `encoded` number
  - `bridgeScan` BridgeScanMetadataDto
  - `simulation` SimulationDto
    - `source` 'TENDERLY' | 'RPC' | 'SOLANA_RUNTIME' | 'NONE', required
    - `executionStatus` 'SUCCESS' | 'REVERTED' | 'TIMEOUT' | 'SKIPPED' | 'UNSUPPORTED' | 'ERROR', required
    - `outputValidation` 'VERIFIED' | 'UNVERIFIABLE' | 'NOT_SIMULATED', required
    - `simulatedOutputAmount` string
    - `advertisedOutputAmount` string, required
    - `deviation` SimulationDeviationDto
      - `absolute` string, required — Simulated output minus advertised output in raw units.
      - `bps` number, required — Signed basis points. Negative means the adapter overstated output.
      - `percent` string, required
    - `gasUsed` string
    - `reason` string
    - `latencyMs` number, required
    - `providerResults` SimulationProviderResultDto[], required
      - `source` 'TENDERLY' | 'RPC' | 'SOLANA_RUNTIME' | 'NONE', required
      - `executionStatus` 'SUCCESS' | 'REVERTED' | 'TIMEOUT' | 'SKIPPED' | 'UNSUPPORTED' | 'ERROR', required
      - `outputValidation` 'VERIFIED' | 'UNVERIFIABLE' | 'NOT_SIMULATED', required
      - `simulatedOutputAmount` string
      - `deviation` SimulationDeviationDto
        - `absolute` string, required — Simulated output minus advertised output in raw units.
        - `bps` number, required — Signed basis points. Negative means the adapter overstated output.
        - `percent` string, required
      - `gasUsed` string
      - `reason` string
      - `latencyMs` number, required
  - `usd` QuoteUsdPricesDto
    - `originCurrency` TokenPriceResultDto, required
      - `chainId` number, required
      - `token` string, required
      - `priceUSD` string — Cached USD price as a decimal string, when available.
      - `source` string — Price source used for this cached value, when available.
      - `updatedAt` string — Timestamp of the cached token price, when available.
      - `stale` boolean, required — Whether this cached value is outside Delora's freshness window.
      - `tier` 'hot' | 'cold', required — Price refresh tier. `hot` entries are prioritized for fresher cached prices; `cold` entries refresh less aggressively.
      - `refreshing` boolean, required — Whether a background refresh for this price is scheduled or already running.
    - `destinationCurrency` TokenPriceResultDto, required
      - `chainId` number, required
      - `token` string, required
      - `priceUSD` string — Cached USD price as a decimal string, when available.
      - `source` string — Price source used for this cached value, when available.
      - `updatedAt` string — Timestamp of the cached token price, when available.
      - `stale` boolean, required — Whether this cached value is outside Delora's freshness window.
      - `tier` 'hot' | 'cold', required — Price refresh tier. `hot` entries are prioritized for fresher cached prices; `cold` entries refresh less aggressively.
      - `refreshing` boolean, required — Whether a background refresh for this price is scheduled or already running.

## Other responses

- `400` — Invalid request parameters.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/deloraprotocol/apis/delora-api.md) · [All operations](https://skmtc.net/deloraprotocol/apis/delora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deloraprotocol/delora-api/versions/99a03dcc3e3b/schema)