Get a quote

The first step is to retrieve swap details — route, estimated output, slippage guardrails, and fees.

Endpoint POST /public/emigroswap/quote

Request fields

fromTokenAddress (address) – input ERC-20.
toTokenAddress (address) – desired output ERC-20.
amount (string, HUMAN) – e.g., "100.00".
chainId (number) – e.g., 8453 for Base.
slippage (number, %) – e.g., 0.5 (optional; default configured on server).

What comes back

Always:
- amountOut (RAW of input token) – use later in build (it’s your exact input in base units).
- minAmountIn (RAW of output token) – use later in build (slippage already applied).
- estimatedAmount, priceImpactPercent, liquidityPoolFeePercent, routerType, etc.
- path (address[]) – canonical path; single-hop is [tokenIn, tokenOut].
If multi-hop:
- multihop (array of hops) – includes per-hop feeTier/tickSpacing information.

You may receive either a single-hop quote (multihop: null) or a multi-hop quote (multihop: [...]). The difference only affects how you build calldata in the next step.

curl -X POST "https://api.emigro.co/public/emigroswap/quote" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_EMIGRO_API_KEY" \
  -d '{
    "fromTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "toTokenAddress":   "0xE9185Ee218cae427aF7B9764A011bb89FeA761B4",
    "amount":           "100.00",
    "chainId":          8453,
    "slippage":         0.5
  }'

import { HttpService } from '@nestjs/axios';
import { firstValueFrom } from 'rxjs';
import { AxiosResponse } from 'axios';

// Minimal self-contained Nest-style example
async function main() {
  const EMIGRO_API_KEY = 'YOUR_EMIGRO_API_KEY';
  const BASE_URL = 'https://api.emigro.co';

  const http = new HttpService();

  const body = {
    fromTokenAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base
    toTokenAddress:   '0xE9185Ee218cae427aF7B9764A011bb89FeA761B4', // BRZ on Base
    amount:           '100.00',
    chainId:          8453,
    slippage:         0.5
  };

  const headers = {
    'x-api-key': EMIGRO_API_KEY,
    'Content-Type': 'application/json'
  };

  try {
    const response: AxiosResponse = await firstValueFrom(
      http.post(`${BASE_URL}/public/emigroswap/quote`, body, { headers })
    );

    console.log('✅ Quote response:');
    console.log(JSON.stringify(response.data, null, 2));

  } catch (error: any) {
    console.error('❌ Error fetching quote:', error?.response?.data || error.message);
  }
}

main();

Single-hop sample (USDC→BRZ on Base)

{
    "fromTokenAddress":  "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "toTokenAddress":  "0xE9185Ee218cae427aF7B9764A011bb89FeA761B4",
    "chainId":  8453,
    "inputAmount":  "100",
    "estimatedAmount":  "535.353595078697830385",
    "fromTokenDecimals":  6,
    "toTokenDecimals":  18,
    "humanAmountOut":  "100",
    "amountOut":  "100000000",
    "rawQuote":  "535353595078697830385",
    "humanRawQuote":  "535.353595078697830385",
    "amountIn":  "535353595078697830385",
    "humanAmountIn":  "535.353595078697830385",
    "minAmountIn":  "532676827103304341233",
    "humanMinAmountIn":  "532.67682710330434123308",
    "emigroFeeAmount":  "500000",
    "emigroFeePercent":  "0.50",
    "slippagePercent":  "0.50",
    "routerType":  "aerodrome-slipstream",
    "feeTier":  500,
    "routeAllowed":  false,
    "liquidityPoolFeePercent":  "0.05",
    "priceImpactPercent":  "0.0000",
    "feeAmount":  "0.5",
    "multihop":  null,
    "path":  [
                 "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                 "0xE9185Ee218cae427aF7B9764A011bb89FeA761B4"
             ],
    "displayPath":  [
                        {
                            "address":  "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                            "symbol":  "USDC",
                            "logoURI":  "usdc.png"
                        },
                        {
                            "address":  "0xE9185Ee218cae427aF7B9764A011bb89FeA761B4",
                            "symbol":  "BRZ",
                            "logoURI":  "brz.png"
                        }
                    ],
    "displayPathText":  "USDC \u003e BRZ",
    "routerDisplay":  {
                          "key":  "aerodrome-slipstream",
                          "name":  "Aerodrome Slipstream"
                      }
}

Multi-hop sample (EURC→USDC→BRZ on Base)

{
    "fromTokenAddress":  "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42",
    "toTokenAddress":  "0xE9185Ee218cae427aF7B9764A011bb89FeA761B4",
    "chainId":  8453,
    "inputAmount":  "100",
    "estimatedAmount":  "621.148169618859643454",
    "fromTokenDecimals":  6,
    "toTokenDecimals":  18,
    "humanAmountOut":  "100",
    "amountOut":  "100000000",
    "rawQuote":  "621148169618859643454",
    "humanRawQuote":  "621.148169618859643454",
    "amountIn":  "621148169618859643454",
    "humanAmountIn":  "621.148169618859643454",
    "minAmountIn":  "618042428770765345237",
    "humanMinAmountIn":  "618.04242877076534523673",
    "emigroFeeAmount":  "500000",
    "emigroFeePercent":  "0.50",
    "slippagePercent":  "0.50",
    "routerType":  "aerodrome-slipstream",
    "feeTier":  500,
    "routeAllowed":  false,
    "liquidityPoolFeePercent":  "0.05",
    "priceImpactPercent":  "0.0000",
    "feeAmount":  "0.5",
    "multihop":  [
                     {
                         "fromTokenAddress":  "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42",
                         "toTokenAddress":  "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                         "fromTokenSymbol":  "EURC",
                         "toTokenSymbol":  "USDC",
                         "feeTier":  50
                     },
                     {
                         "fromTokenAddress":  "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                         "toTokenAddress":  "0xE9185Ee218cae427aF7B9764A011bb89FeA761B4",
                         "fromTokenSymbol":  "USDC",
                         "toTokenSymbol":  "BRZ",
                         "feeTier":  10
                     }
                 ],
    "path":  [
                 "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42",
                 "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                 "0xE9185Ee218cae427aF7B9764A011bb89FeA761B4"
             ],
    "displayPath":  [
                        {
                            "address":  "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42",
                            "symbol":  "EURC",
                            "logoURI":  "eurc.png"
                        },
                        {
                            "address":  "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                            "symbol":  "USDC",
                            "logoURI":  "usdc.png"
                        },
                        {
                            "address":  "0xE9185Ee218cae427aF7B9764A011bb89FeA761B4",
                            "symbol":  "BRZ",
                            "logoURI":  "brz.png"
                        }
                    ],
    "displayPathText":  "EURC \u003e USDC \u003e BRZ",
    "routerDisplay":  {
                          "key":  "aerodrome-slipstream",
                          "name":  "Aerodrome Slipstream"
                      }
}

The quote tells you how much output to expect (estimatedAmount) and the minimum acceptable amount to protect against slippage (minAmountIn), both already accounting for any fee settings.

displayPath/displayPathText are convenience fields sourced from Emigro’s DB; treat them as optional.

PreviousRequirements NextApprove token allowence

Last updated 1 month ago

Good evening