Skip to main content
Delora API provides two ways to request execution paths: /v1/quotes and /v1/advanced/routes. They serve different needs depending on how much control and detail an integrator requires.

/v1/quotes - Simplified Execution

The /v1/quotes endpoint is designed for ease of integration and smooth UX.
  • Returns a single, optimized route (swap, bridge, or a combination).
  • Can include multi-step flows (e.g., bridge + swap), but the complexity is abstracted away.
  • Provides ready-to-sign transaction data, so the user only needs to confirm one execution.
  • Best choice for dApps that want one-click integration without handling multiple steps.
πŸ”‘ Takeaway: /v1/quotes = simple, packaged, and user-friendly. Even complex routes are flattened into one transaction flow.

/v1/advanced/routes - Advanced Control

The /v1/advanced/routes endpoint is designed for flexibility and transparency.
  • Returns multiple possible routes to the same destination.
  • Exposes the full structure of the route, including each step (bridge, swap, relayer interaction).
  • Requires generating per-step transaction data via /v1/advanced/stepTransaction.
  • Allows developers to implement custom logic such as:
    • fallback routes,
    • per-leg limits (minOut, slippage, deadlines),
    • monitoring and analytics at the step level.
  • Treats route results as estimates. Each selected step is re-quoted when stepTransaction is called.
πŸ”‘ Takeaway: /v1/advanced/routes = advanced routing for developers who need control over every step.

When to Use

  • Use /v1/quotes when you want the fastest path to integration and a smooth UX: one endpoint, one signature, one execution.
  • Use /v1/advanced/routes when you need more flexibility, visibility into all possible paths, or the ability to add custom execution logic.

Example

  • With /v1/quotes:
    User wants to send USDC from Solana and receive DAI on Base. Delora may internally build a route = USDC (Solana) β†’ Bridge β†’ USDC (Base) β†’ Swap β†’ DAI (Base).
    The integrator only gets one packaged transaction for the user to sign.
  • With /v1/advanced/routes:
    The same request returns several possible multi-step routes, e.g.:
    • Route 1: Bridge via Wormhole + Swap on Uniswap.
    • Route 2: Bridge via Stargate + Swap on Curve.