Get an Offramp Quote

Use a draft quote to show users what to expect before converting stablecoins to fiat. You can start from either side of the conversion. For example, enter 300 USDC to see the estimated payout in Mexican pesos, or enter 4,500 MXN to see how much USDC the user would need to send. The quote also includes the applicable fees. Crossmint does not store a draft, and a draft cannot be paid or turned into an order. Display the quote, then discard the response. When the user proceeds, create a new order.

Request a Quote

Call Create Order with state: "draft". The rest of the body is the same as a real order. Use exact-in to fix the stablecoin the user sends, or exact-out to fix the fiat they receive (see Send or Receive an Exact Amount). Both code samples pay out in MXN.

exact-in
exact-out

The user sends exactly 300 USDC and the quote estimates how many MXN they receive after fees.

cURL

curl -X POST 'https://staging.crossmint.com/api/2022-06-09/orders' \
  -H 'X-API-KEY: <YOUR_SERVER_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "state": "draft",
    "recipient": {
      "paymentMethodId": "<PAYMENT_METHOD_ID>"
    },
    "payment": {
      "method": "base-sepolia",
      "currency": "usdc",
      "payerAddress": "<USER_WALLET_ADDRESS>",
      "receiptEmail": "alice@example.com"
    },
    "lineItems": {
      "currencyLocator": "fiat:mxn",
      "executionParameters": {
        "mode": "exact-in",
        "amount": "300"
      }
    }
  }'

The user wants to receive exactly 4,500 MXN and the quote calculates how much USDC they must send, fees included.

cURL

curl -X POST 'https://staging.crossmint.com/api/2022-06-09/orders' \
  -H 'X-API-KEY: <YOUR_SERVER_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "state": "draft",
    "recipient": {
      "paymentMethodId": "<PAYMENT_METHOD_ID>"
    },
    "payment": {
      "method": "base-sepolia",
      "currency": "usdc",
      "payerAddress": "<USER_WALLET_ADDRESS>",
      "receiptEmail": "alice@example.com"
    },
    "lineItems": {
      "currencyLocator": "fiat:mxn",
      "executionParameters": {
        "mode": "exact-out",
        "amount": "4500"
      }
    }
  }'

Read the Quote

Response excerpts for each mode. The amounts are illustrative.

exact-in
exact-out

The user sends 300 USDC, pays 0.24 USDC in fees, and the remaining 299.76 USDC converts into an estimated 5,137.89 MXN (quantity).

Draft response (excerpt)

{
  "order": {
    "orderId": "<ORDER_ID>",
    "phase": "payment",
    "lineItems": [
      {
        "metadata": {
          "name": "MXN",
          "description": "Mexican Peso",
          "imageUrl": "https://www.crossmint.com/assets/ui/flags/mx.svg"
        },
        "quote": {
          "status": "valid",
          "charges": {
            "fees": {
              "type": "exact",
              "amount": "0.24",
              "currency": "usdc"
            }
          },
          "totalPrice": {
            "amount": "300",
            "currency": "usdc"
          }
        },
        "quantity": 5137.89,
        "delivery": {
          "status": "awaiting-payment",
          "recipient": {
            "locator": "paymentMethodId:<PAYMENT_METHOD_ID>",
            "paymentMethodId": "<PAYMENT_METHOD_ID>"
          }
        },
        "executionMode": "exact-in",
        "callData": {
          "mode": "exact-in",
          "amount": "300",
          "outFiatCurrency": "mxn",
          "effectiveAmount": "299.76"
        }
      }
    ],
    "quote": {
      "status": "valid",
      "quotedAt": "2026-09-15T19:16:57.608Z",
      "expiresAt": "2026-09-15T19:26:57.608Z",
      "totalPrice": {
        "amount": "300",
        "currency": "usdc"
      }
    },
    "payment": {
      "status": "requires-crypto-payer-address",
      "method": "base-sepolia",
      "currency": "usdc"
    }
  }
}

The user receives exactly 4,500 MXN, which costs 262.54 USDC to convert; 0.21 USDC in fees is added on top, so they send 262.75 USDC (totalPrice). Amounts are rounded here; the response keeps full precision.

Draft response (excerpt)

{
  "order": {
    "orderId": "<ORDER_ID>",
    "phase": "payment",
    "lineItems": [
      {
        "metadata": {
          "name": "MXN",
          "description": "Mexican Peso",
          "imageUrl": "https://www.crossmint.com/assets/ui/flags/mx.svg"
        },
        "quote": {
          "status": "valid",
          "charges": {
            "fees": {
              "type": "exact",
              "amount": "0.210035",
              "currency": "usdc"
            }
          },
          "totalPrice": {
            "amount": "262.753792",
            "currency": "usdc"
          }
        },
        "quantity": 4500,
        "delivery": {
          "status": "awaiting-payment",
          "recipient": {
            "locator": "paymentMethodId:<PAYMENT_METHOD_ID>",
            "paymentMethodId": "<PAYMENT_METHOD_ID>"
          }
        },
        "executionMode": "exact-out",
        "callData": {
          "mode": "exact-out",
          "amount": "4500",
          "outFiatCurrency": "mxn",
          "effectiveAmount": "262.543757"
        }
      }
    ],
    "quote": {
      "status": "valid",
      "quotedAt": "2026-09-15T21:13:28.476Z",
      "expiresAt": "2026-09-15T21:23:28.476Z",
      "totalPrice": {
        "amount": "262.753792",
        "currency": "usdc"
      }
    },
    "payment": {
      "status": "requires-crypto-payer-address",
      "method": "base-sepolia",
      "currency": "usdc"
    }
  }
}

Display the Quote

Use these fields to build the quote summary:

Field	Show the user
`quote.totalPrice.amount`	Stablecoin to send, including Crossmint fees
`lineItems[0].quote.charges.fees.amount`	Crossmint fees, included in the total
`lineItems[0].callData.effectiveAmount`	Stablecoin actually converted, after fees
`lineItems[0].quantity`	Estimated fiat payout, expected in the destination account

Place the Order

Once the user is ready to continue, discard the draft and send the request again without state: "draft". The draft was only a preview and cannot be reused. The new order includes a fresh quote and instructions for sending the funds. If the amounts have changed, show the updated quote to the user before continuing.

Introduction

Quickstarts ⚡

Concepts

Guides

API Reference

Request a Quote

Read the Quote

Display the Quote

Place the Order

Next Steps

Manage Orders

Create Order API

​Request a Quote

​Read the Quote

​Display the Quote

​Place the Order

​Next Steps

Manage Orders

Create Order API

Request a Quote

Read the Quote

Display the Quote

Place the Order

Next Steps