Sign in
V1

Get the best executable quote

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

Query parameters

senderAddressstring required
Example:0x1111111111111111111111111111111111111111

Sender wallet address on the origin chain.

receiverAddressstring
Example:0x2222222222222222222222222222222222222222

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).

originChainIdnumber required
Example:8453

Origin chain ID.

destinationChainIdnumber required
Example:8453

Destination chain ID.

amountstring required
Example:1000000

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

originCurrencystring required
Example:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

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

destinationCurrencystring required
Example:0x4200000000000000000000000000000000000006

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

integratorstring
Example:partner-app

Integrator identifier used for fee attribution. Required when fee is provided.

feenumber
Example:0.01

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.

slippagenumber
Example:0.005

Optional slippage fraction. 0.005 means 0.5%.

includeBridgesstring
Example:RELAY,ACROSS

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

includeExchangesstring
Example:OPENOCEAN,OKX

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

excludeBridgesstring
Example:RELAY,ACROSS

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

excludeExchangesstring
Example:OPENOCEAN,OKX

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

Headers

x-api-keystring

Optional API key for higher rate limits and fee rules.

Response

Best executable quote response.

inputAmountstring required
outputAmountstring required
minOutputAmountstring
estimatedTimeSecnumber

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
approvalAddressstring

Approval spender address for EVM-origin routes.

bridgeScanBridgeScanMetadataDto

Example response

{
  "inputAmount": "1000000",
  "outputAmount": "997321",
  "minOutputAmount": "992334",
  "estimatedTimeSec": 120,
  "adapter": "OPENOCEAN",
  "calldata": {
    "to": "0x1111111111111111111111111111111111111111",
    "value": "0x0",
    "data": "0xabcdef"
  },
  "fees": {
    "total": {
      "amount": "2679",
      "currencySymbol": "USDC",
      "currencyAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "chainId": 8453,
      "decimals": 6
    },
    "breakdown": [
      {
        "amount": "2679",
        "currencySymbol": "USDC",
        "currencyAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "chainId": 8453,
        "decimals": 6,
        "type": "gas",
        "amountUsd": "0.01"
      }
    ],
    "totalUsd": "0.01"
  },
  "gas": {
    "gasPrice": "0x3b9aca00",
    "maxFeePerGas": "0x59682f00",
    "maxPriorityFeePerGas": "0x3b9aca00"
  },
  "warnings": [
    {
      "code": "SOLANA_INSUFFICIENT_BALANCE",
      "message": "Solana simulation reported insufficient balance."
    }
  ],
  "approvalAddress": "0x1111111111111111111111111111111111111111",
  "transactionSize": {
    "raw": 812,
    "encoded": 1084
  },
  "simulation": {
    "source": "TENDERLY",
    "executionStatus": "SUCCESS",
    "outputValidation": "VERIFIED",
    "simulatedOutputAmount": "996100",
    "advertisedOutputAmount": "997321",
    "deviation": {
      "absolute": "-1200",
      "bps": -12,
      "percent": "-0.12%"
    },
    "gasUsed": "142331",
    "reason": "Simulation exceeded budget",
    "latencyMs": 712,
    "providerResults": [
      {
        "source": "TENDERLY",
        "executionStatus": "SUCCESS",
        "outputValidation": "VERIFIED",
        "simulatedOutputAmount": "996100",
        "deviation": {
          "absolute": "-1200",
          "bps": -12,
          "percent": "-0.12%"
        },
        "gasUsed": "142331",
        "reason": "Exceeded 700ms",
        "latencyMs": 312
      }
    ]
  },
  "usd": {
    "originCurrency": {
      "chainId": 8453,
      "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "priceUSD": "1.00",
      "source": "dexscreener",
      "updatedAt": "2026-06-22T12:00:00.000Z",
      "tier": "hot"
    },
    "destinationCurrency": {
      "chainId": 8453,
      "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "priceUSD": "1.00",
      "source": "dexscreener",
      "updatedAt": "2026-06-22T12:00:00.000Z",
      "tier": "hot"
    }
  }
}

Changes

Changed in 2 of the 8 revisions of this API.78

  • fa9617c7c0a94See the full diff
    • ●

      added the new AMOUNT_TOO_LOW enum value to the code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new AMOUNT_TOO_LOW enum value to the code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new SLIPPAGE_EXCEEDED enum value to the code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new SLIPPAGE_EXCEEDED enum value to the code response property for the response status 429

      response-property-enum-value-added

  • 85b3d9b4fd8438See the full diff
    • ●

      added the new DFLOW enum value to the adapter response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new KYBERSWAP enum value to the adapter response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new NEAR_INTENTS enum value to the adapter response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new optional query request parameter includeBridges

      new-optional-request-parameter

    • ○

      added the new optional query request parameter includeExchanges

      new-optional-request-parameter

    • ○

      added the optional property approvalAddress to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property bridgeScan to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property estimatedTimeSec to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property simulation to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property transactionSize to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property usd to the response with the 200 status

      response-optional-property-added