Velora quickstart: quote your first swap

Get a quote for 1 ETH → USDC on Ethereum mainnet. With mode=ALL, Velora picks the best execution path server-side and returns one response shape: either a delta block (gasless, signed and submitted later) or a market block (calldata-ready, submitted immediately). See Trading modes.

curl -s "https://api.velora.xyz/v2/quote" \
  --data-urlencode "srcToken=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE" \
  --data-urlencode "destToken=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" \
  --data-urlencode "amount=1000000000000000000" \
  --data-urlencode "srcDecimals=18" \
  --data-urlencode "destDecimals=6" \
  --data-urlencode "side=SELL" \
  --data-urlencode "chainId=1" \
  --data-urlencode "mode=ALL" \
  --data-urlencode "userAddress=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" \
  --data-urlencode "partner=my-app-name" \
  -G | jq

import { constructSimpleSDK } from '@velora-dex/sdk';

const sdk = constructSimpleSDK({ chainId: 1, fetch });

const quote = await sdk.quote.getQuote({
  srcToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE', // ETH
  destToken: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', // USDC
  amount: '1000000000000000000', // 1 ETH
  srcDecimals: 18,
  destDecimals: 6,
  side: 'SELL',
  mode: 'ALL',
  userAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
  partner: 'my-app-name',
});

if ('delta' in quote) {
  // gasless path: sign and submit via /v2/delta/orders
} else {
  // calldata path: submit `market` to /transactions
}

import { Widget } from '@velora-dex/widget';

export default function SwapPage() {
  return (
    <Widget
      partnerConfig={{ partner: "my-app-name" }}
      input={{
        selectedForm: "swap",
        tokenFromAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
        tokenToAddress: "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",   // ETH
        srcChainId: 1, // Mainnet
        destChainId: 1, // Mainnet
        sendAmount: "1000", // 1000 USDC in units
      }}
    />
  );
}

my-app-name is a placeholder. Replace it with your own app or project partner identifier. It tags your integration for analytics, support, and rate-limit upgrades; it is not an API key, and no signup is required.

GET /v2/quote?mode=DELTA returns a delta block (sign with EIP-712, submit to /v2/delta/orders). GET /v2/quote?mode=MARKET returns a market block (calldata-ready against Augustus v6.2). GET /v2/quote?mode=ALL lets Velora pick the path server-side and returns one of response.delta (Delta intent) or response.market (Market route), never both. Branch on which block is present. See Trading modes.

Pick your integration path

Continue to Integrate →

Compare API, SDK, and Widget, then choose the right surface for your stack.

All endpoints work as soon as you pass a partner identifier; you don’t need to sign up for anything. When you’re ready for higher throughput, a dashboard, and SLA-backed support, grab a Pro API account or reach out for bespoke arrangements.

​Pick your integration path

Continue to Integrate →

Pick your integration path