Request Trade Quotes

import { DZapClient } from "@dzap/sdk";

const dZap = DZapClient.getInstance();

const quotesRequest: TradeQuotesRequest = {
  integratorId: "your-integrator-id", // Your unique integrator ID (use "dzap" for testing)
  fromChain: 42161, // Arbitrum
  data: [
    {
      amount: "1000000", // 1 USDC (6 decimals)
      srcToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", // USDC on Arbitrum
      destToken: "0x4200000000000000000000000000000000000006", // WETH on Base
      toChain: 8453, // Base Chain
      slippage: 1, // 1% slippage
    },
  ],
  account: userAccount, // User's wallet address (optional)
};

const result = await dZap.getTradeQuotes(quotesRequest);
const quotes = result.quotes;

const quotesRequest: TradeQuotesRequest = {
  integratorId: "your-integrator-id",
  fromChain: 42161,
  data: [
    {
      amount: "1000000",
      srcToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      destToken: "0x4200000000000000000000000000000000000006",
      toChain: 8453,
      slippage: 1,
    },
  ],
  account: userAccount,
  filter: "best", // Only return the best quote
};

const quotesRequest: TradeQuotesRequest = {
  integratorId: "your-integrator-id",
  fromChain: 42161,
  data: [
    {
      amount: "1000000",
      srcToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      destToken: "0x4200000000000000000000000000000000000006",
      toChain: 8453,
      slippage: 1,
    },
  ],
  account: userAccount,
  
  // Advanced timing configuration for optimal quote collection
  timingStrategy: {
    minWaitTimeMs: 1500,      // Wait at least 1.5 seconds for provider responses
    maxWaitTimeMs: 4000,      // Don't wait more than 4 seconds total
    subsequentDelayMs: 300,   // 300ms between provider batches
    preferredResultCount: 5,  // Try to collect 5 different quotes
  },
  
  // Disable pricing for faster response in high-frequency scenarios
  disablePricing: true,
};

type TimingStrategy = Partial<{
  minWaitTimeMs: number;        // Minimum wait time before returning results
  maxWaitTimeMs: number;        // Maximum wait time for quote optimization
  subsequentDelayMs: number;    // Delay between subsequent quote requests
  preferredResultCount: number; // Target number of quote results to collect
}>;

## Understanding the Response

The response contains detailed information about available routes:

```typescript
type TradeQuotesResponse = {
  [pair: string]: {
    recommendedSource: string;
    quoteRates: TradeQuotesByProviderId;
    tokensWithoutPrice: Record<number, string[]>; // Tokens without price data by chain ID
  };
};

const result = await dZap.getTradeQuotes(quotesRequest);

// Get the pair key (usually the first and only one for single trades)
const pairKey = Object.keys(result)[0];
const pairData = result[pairKey];

// Get the recommended route
const recommendedProvider = pairData.recommendedSource;
const recommendedQuote = pairData.quoteRates?.[recommendedProvider];

if (recommendedQuote) {
  console.log("Best route details:");
  console.log("Source amount:", recommendedQuote.srcAmount);
  console.log("Destination amount:", recommendedQuote.destAmount);
  console.log("Provider:", recommendedQuote.providerDetails.name);
  console.log("Estimated duration:", recommendedQuote.duration);
  console.log("Price impact:", recommendedQuote.priceImpactPercent);
}