Sign in

v8

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-01124480.3 KB
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"
    }
  }
}
All 12 operations