Skip to main content
An estimate previews a price; a quote supplies funding instructions and pricing valid until expiresAt. Fees explains the cost breakdown.

Estimates and quotes

GET /estimate is stateless and allocates no deposit address. It needs no key unless you pass affiliate fields. Use it as inputs change. POST /quote requires a key, persists the quote, and returns deposit instructions. Its pricing lasts 2 minutes, subject to slippage. For Fixed-output quotes, set amountMode: "exact_in" and deliveryMode: "fixed". The quote commits to estimatedOut with timely, full funding. Underpayment can reduce the payout or hold the order for review; overpayment does not increase it. Fixed-output quotes are available to approved partners on routes listed in fixedTo. /estimate is indicative; /quote confirms availability. Unsupported requests fail. Check the returned deliveryMode before funding. Both endpoints use route-dependent slippageBps defaults and minimums. Omit it to use the route’s default. Fund before expiresAt. Eligible late funding for variable quotes uses refreshed market pricing; some expired submissions are rejected. Late funding for fixed-output quotes is held for review and does not retain the quoted payout guarantee.

Amounts

Amounts are integer strings in smallest units: "50000000" is 50 Base USDC; "100000" is 0.001 BTC. Read each asset’s decimals from /routes.
  • exact_in (default): amount is source units. Read amountIn and estimatedOut.
  • exact_out: amount is destination units. Read targetAmountOut, requiredAmountIn, maxAcceptedAmountIn, and inputBufferBps. The destination must be in exactOutTo. Stablecoin targets must be whole cents, such as multiples of 10000 for a 6-decimal asset.
Onramp and pay links accept amountFiatUsd instead of amount. Eligible stablecoin onramps can select fiat-capped exact-out when partner fees are invoiced and no app or affiliate fees apply. Explicit exact_in prevents that selection. Use the returned mode and amounts. /quote requires refundAddress for exact-out and Lightning destinations. Onramp leaves it optional, but missing refund details can obstruct recovery. Supply a valid refund target wherever supported. Lightning destinations on /quote take a BOLT11 invoice as recipientAddress: amountless for exact-in; amountless or matching the target for exact-out. To pay a Cash App username or Lightning address from a deposited asset, use Offramp. That call rejects invoices and URLs. Send the returned amountIn. Accepted differences can update input, fees, and output; route minimums, maximums, and funding rules still apply. Dust may create no order, and over-limit funding can be held. Lightning source invoices fix the amount.