Get quote

Get the best route and expected output amount.

What /quote returns

GET /quote returns the best route and expected output amount.

It does not return transaction calldata.

Request parameters

• tokenIn — input token address.

• tokenOut — output token address.

• amount — input amount in raw units.

• slippageBps — optional slippage in basis points. Default: 50.

• excludeSources — optional comma-separated source IDs.

Example request

curl "https://api.dirol.io/api/v1/quote?tokenIn=0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A&tokenOut=0x754704Bc059F8C67012fEd69BC8A327a5aafb603&amount=1000000000000000000"

Example response

{
  "tokenIn": "0x3bd359c1119da7da1d913d1c4d2b7c461115433a",
  "tokenOut": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
  "amountIn": "1000000000000000000",
  "amountOut": "385274",
  "routes": [
    {
      "pool": "0xab12...ef34",
      "poolType": "V3",
      "tokenIn": "0x3bd359c1119da7da1d913d1c4d2b7c461115433a",
      "tokenOut": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
      "tokenInSymbol": "WMON",
      "tokenOutSymbol": "USDC",
      "factory": "CapricornV3",
      "factoryAddress": "0x...",
      "amountIn": "1000000000000000000",
      "amountOut": "385274",
      "weight": 10000
    }
  ],
  "priceImpactBps": 12,
  "amountInUsd": "0.39",
  "amountOutUsd": "0.39"
}

JavaScript example

const params = new URLSearchParams({
  tokenIn: "0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A",
  tokenOut: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
  amount: "1000000000000000000",
  slippageBps: "50"
});

const res = await fetch(`https://api.dirol.io/api/v1/quote?${params}`);
const quote = await res.json();

console.log(quote.amountOut);
console.log(quote.routes);

How to read routes

Each item in routes is one swap step.

Direct route

A direct route has one step.

The step moves from tokenIn to tokenOut through one pool.

Multi-hop route

A multi-hop route has multiple steps.

The tokenOut of one step matches the tokenIn of the next.

Example:

• Step 1: USDT -> WMON

• Step 2: WMON -> USDC

Split route

A split route uses multiple pools for the same swap.

In that case, steps can share the same tokenIn and tokenOut but use different pools.

Use weight to see each split in basis points.

• 10000 means 100%

• 6000 means 60%

• 2500 means 25%

Excluding sources

Pass source IDs in excludeSources to skip specific venues.

curl "https://api.dirol.io/api/v1/quote?tokenIn=0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A&tokenOut=0x754704Bc059F8C67012fEd69BC8A327a5aafb603&amount=1000000000000000000&excludeSources=Kuru,CapricornV3"

Notes

• amount must be an integer string in raw units.

• amountOut is the optimized output estimate.

• priceImpactBps is the estimated price impact.

• Use /swap when you need an executable transaction.