Trade Quotes

This endpoint provides quotes for different order types: market, limit, and TWAP (Time-Weighted Average Price). Quotes include pricing information, expected slippage, and other trade details.

Request URL

https://ddp.definitive.fi/v1/trade/quote

Request Body

The request body varies based on the order type:

Base Parameters (All Order Types)

{
  "type": "market" | "limit" | "twap",
  "chain": "ethereum" | "optimism" | "arbitrum" | "avalanche" | "polygon" | "base" | "solana" | "blast",
  "from": "0x...", // Asset address to sell/buy from
  "to": "0x...", // Asset address to buy/sell to
  "qty": "1000.00", // Amount to trade
  "orderSide": "buy" | "sell", // Whether buying the 'to' asset or selling the 'from' asset
  "slippageTolerance": "0.01", // Maximum acceptable slippage (1% = 0.01)
  "maxPriceImpact": "0.05" // Maximum acceptable price impact (5% = 0.05)
}

Market Order

For market orders, only the base parameters are required:

{
  "type": "market",
  // Base parameters...
}

Limit Order

Limit orders require additional parameters:

{
  "type": "limit",
  // Base parameters...
  "limitPrice": "0.5", // The limit price
  "limitNotionalPrice": "2000.00", // Optional: limit in notional value
  "limitNotionalAsset": "0x..." // Optional: asset for notional pricing
}

TWAP Order

TWAP orders require additional parameters:

{
  "type": "twap",
  // Base parameters...
  "durationSeconds": 3600, // Duration of the TWAP execution in seconds
  "targetTWAPBuckets": 6 // Optional: Number of buckets to divide the order into
}

Response

{
  "quote": {
    "from": "0xA12B34C56D78E90F12AB34CD56EF78A901BC234D", // From token address
    "to": "0xF98765C43210D78E90AB56CD12EF34A908BC765D", // To token address
    "chain": "base",
    "qty": "1000.00",
    "orderSide": "sell",
    "maxPriceImpact": "0.05",
    "slippageTolerance": "0.01",
    "quoteId": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
    "quotedAmountOut": "0.050123",
    "quotedPriceImpact": "0.025",
    "type": "market" // or "limit" or "twap" with respective additional fields
  },
  "metadata": {
    "toNotional": "1000.00",
    "fromNotional": "1005.25",
    "estimatedPriceImpact": "0.025",
    "estimatedFee": "0.75",
    "estimatedFeeNotional": "0.75",
    "buyAmount": "0.050123",
    "sellAmount": "1000.00",
    "sources": {
      "Uniswap_V3": "0.8",
      "SushiSwap": "0.2"
    },
    "expectedSlippage": "0.008",
    "minAmountOut": "0.04962",
    "minAmountOutNotional": "990",
    "price": "19950.123",
    "isMarketable": true
  }
}

Example

const quoteRequest = {
  type: "market",
  chain: "base",
  from: "0xA12B34C56D78E90F12AB34CD56EF78A901BC234D", // EURC
  to: "0xF98765C43210D78E90AB56CD12EF34A908BC765D", // cbBTC
  qty: "1000.00",
  orderSide: "sell",
  slippageTolerance: "0.01",
  maxPriceImpact: "0.05"
};
 
const json = await AuthHelpers.signAndSend({
  path: "/v1/trade/quote",
  method: "POST",
  body: quoteRequest,
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET,
});
console.log(json);

Next Steps

After receiving a quote, the next step is typically to submit the order if you're satisfied with the quote details.