/quote

Retrieve a Delta price, with optional fallback to Market via mode=ALL or mode=MARKET.

GET /v2/quote

Get a Delta V2 quote (Delta price, optional Market fallback)

cURL

curl --request GET \
  --url https://api.velora.xyz/v2/quote

200

{
  "delta": {
    "id": "4899cda3-795d-467d-a5e2-c6633415ecc0",
    "side": "SELL",
    "inputToken": {
      "chainId": 10,
      "address": "0x0b2c639c533813f4aa9d7837caf62653d097ff85"
    },
    "outputToken": {
      "chainId": 10,
      "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
    },
    "route": {
      "origin": {
        "input": {
          "token": {
            "chainId": 10,
            "address": "0x0b2c639c533813f4aa9d7837caf62653d097ff85"
          },
          "amount": "1000000",
          "amountUSD": "0.9995570000"
        },
        "output": {
          "token": {
            "chainId": 10,
            "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
          },
          "amount": "560908985930384",
          "amountUSD": "0.9950301048"
        }
      },
      "destination": {
        "input": {
          "token": {
            "chainId": 10,
            "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
          },
          "amount": "560908985930384",
          "amountUSD": "0.9950301048"
        },
        "output": {
          "token": {
            "chainId": 10,
            "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
          },
          "amount": "560908985930384",
          "amountUSD": "0.9950301048"
        }
      },
      "bridge": null,
      "fees": {
        "gas": {
          "token": {
            "chainId": 10,
            "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
          },
          "amount": "388230",
          "amountUSD": "0.0007580000"
        },
        "bridge": []
      }
    },
    "partner": {
      "name": "paraswap.io-orders",
      "feePercent": 0
    },
    "spender": "0x76e0ebb8d4c6dccb3fdedab7a3e1c87036719a42",
    "alternatives": []
  }
}

With mode=ALL, GET /v2/quote upgrades a Market swap to a gasless, MEV-protected Delta intent whenever a solver can fill, and otherwise returns a market block with the same shape as the GET /prices priceRoute, ready for POST /transactions/:chainId. Routing is decided server-side; when the response falls back to Market, fallbackReason explains why.

This endpoint accepts mode=DELTA, mode=MARKET, or mode=ALL. See Trading modes for guidance and fallback semantics.

Query Parameters

chainId · integer · required

Source chain ID. Supported: 1, 10, 56, 100, 130, 137, 8453, 42161, 43114.

Example:

1

srcToken · string · required

Example:

"0x6B175474E89094C44Da98b954EedeAC495271d0F"

destToken · string · required

Destination token. For crosschain quotes, the destination token on destChainId.

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

amount · string · required

Source amount (SELL) or destination amount (BUY), in raw token units.

Example:

"1000000000000000000"

srcDecimals · integer · required

Example:

18

destDecimals · integer · required

Example:

6

mode · enum<string> · default: ALL

Which execution path to return. DELTA returns the delta block only; MARKET returns the market block only; ALL (default) lets Velora pick and may fall back to Market.

Available options: ALL, DELTA, MARKET

side · enum<string> · default: SELL

Available options: SELL, BUY

destChainId · integer

Omit for same-chain. When set, the delta block's route.bridge is populated.

userAddress · string

beneficiary · string

Address that receives the destination token. Defaults to userAddress.

partner · string · default: anon

Partner key. Defaults to anon (1bps fee).

Example:

"my-app-name"

partnerFeeBps · integer

Override partner fee in basis points (max 200 = 2%).

Required range: 0 <= x <= 200

Response

200

application/json

Delta quote, optionally with a Market block depending on mode.

delta · object

Delta V2 price. Present for mode=DELTA and mode=ALL (when Delta can price). Pass delta.route verbatim to POST /v2/delta/orders/build.

Show child attributes

market · object

Market route block. Same shape as the GET /prices priceRoute field. Present when mode is ALL or MARKET.

fallbackReason · object

Set when Delta couldn't price and the response fell back to Market.

Show child attributes