Skip to Content
CheckoutAPI ReferenceCheckoutsCreate a settlement quote

Create a settlement quote

POST/checkouts/quote

Lock token-specific exchange rates for a fiat-denominated checkout. Pass the returned quote_id when creating a checkout with token-specific signatures.

Headers

HeaderDescriptionRequired
AuthorizationBearer token with your secret API keyyes

Request Body

FieldTypeRequiredDescription
amountintegeryes
currencystringyes

Example Request

Request

const response = await fetch('https://checkout-api.exodus-int.com/checkouts/quote', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "amount": 0,
    "currency": "string"
  }),
});

Responses

StatusDescription
200A quote with locked token rates.
400Validation error
401Missing or invalid authentication

Response body

FieldTypeRequiredDescription
quote_idstringyes
amountnumberyes
currencystringyes
tokensobjectyes

Example Response

{
  "quote_id": "quote_1234567890abcdef",
  "amount": 5000,
  "currency": "USD",
  "tokens": {
    "USDC": {
      "amount": "50000000",
      "canonical_amount": "50",
      "rate": "1.0",
      "expires_at": "2024-01-15T12:05:00Z"
    }
  }
}

Error Response

Error (e.g. 400)

{
  "error": {
    "type": "validation_error",
    "message": "amount must be a positive number",
    "param": "amount"
  }
}

Start building

XO

Request Demo

Schedule a call with our team

Select a product
Arrow right

Start building
Grateful

Contact Us

We're here to help