Skip to main content

​
getCheckoutTransactionQuote

Fetches a conversion quote for a checkout transaction. The quote includes fee breakdowns and the signing payload needed for on-chain execution. Call attachCheckoutTransactionSource before requesting a quote to specify the source wallet and chain.

​
Usage

import { getCheckoutTransactionQuote } from '@dynamic-labs-sdk/client';

const transaction = await getCheckoutTransactionQuote({
  transactionId: 'txn_abc123',
  fromTokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
});

console.log('Total fee:', transaction.quote.fees?.totalFeeUsd);

​
Parameters

ParameterTypeDescription
transactionIdstringThe checkout transaction ID returned by createCheckoutTransaction.
fromTokenAddressstringThe contract address of the token the user is paying with.
slippagenumber (optional)Maximum allowed slippage as a decimal (e.g., 0.005 for 0.5%).

​
Returns

Promise<CheckoutTransaction> - The updated transaction with quote data populated: 
type CheckoutTransactionQuote = {
  estimatedTimeSec: number;          // Estimated execution time
  fees?: CheckoutFeeBreakdown;       // Fee details
  signingPayload: object;            // Data for on-chain signing
  // ... additional quote fields
};

type CheckoutFeeBreakdown = {
  totalFeeUsd?: string;              // Total fees in USD
  // ... individual fee components
};

​
Examples

​
Display quote to user

import {
  attachCheckoutTransactionSource,
  getCheckoutTransactionQuote,
  getActiveNetworkData,
} from '@dynamic-labs-sdk/client';

const getQuote = async (transactionId, walletAccount, tokenAddress) => {
  const { networkData } = await getActiveNetworkData({ walletAccount });

  // Attach source wallet
  await attachCheckoutTransactionSource({
    transactionId,
    fromAddress: walletAccount.address,
    fromChainId: networkData?.networkId ?? '',
    fromChainName: walletAccount.chain,
  });

  // Fetch quote
  const transaction = await getCheckoutTransactionQuote({
    transactionId,
    fromTokenAddress: tokenAddress,
  });

  const { quote } = transaction;
  console.log(`Amount: $${transaction.amount}`);
  console.log(`Fees: $${quote.fees?.totalFeeUsd ?? '0.00'}`);

  return transaction;
};

​
With custom slippage

import { getCheckoutTransactionQuote } from '@dynamic-labs-sdk/client';

const transaction = await getCheckoutTransactionQuote({
  transactionId: 'txn_abc123',
  fromTokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
  slippage: 0.01, // 1% slippage tolerance
});