client.getQuote()

Use this method to request a quote for fiat-to-crypto transactions. Quotes include fees and limits, and they expire after a short time window. A quote with executable: true can be used to execute a transaction.

Get a quote

import { createClient } from "@moonpay/platform-sdk-web";

const client = createClient({ sessionToken: "c3N0XzAwMQ==" });

const quoteResult = await client.getQuote({
  source: { asset: { code: "USD" }, amount: "100.00" },
  destination: { asset: { code: "ETH" } },
  wallet: { address: "0x1234567890123456789012345678901234567890" },
  paymentMethod: { type: "apple_pay" },
});

if (!quoteResult.ok) {
  // Handle error
  console.error(quoteResult.error.code, quoteResult.error.message);
  return;
}

console.log(quoteResult.value.data);

Parameters

client.getQuote() takes a single input object. The shape matches the Get quotes API request body — see that page for the complete field reference.

Field	Type	Required	Description
`source`	`object`	✅	The fiat side of the quote.
`source.asset.code`	`string`	✅	The fiat currency code as ISO 4217 (for example, `"USD"`).
`source.amount`	`string`		The amount to spend, as a string (for example, `"100.00"`). Set the amount on either `source` or `destination`, not both.
`destination`	`object`	✅	The crypto side of the quote.
`destination.asset.code`	`string`	✅	The crypto asset code the customer receives (for example, `"ETH"`, `"USDC_SOL"`).
`destination.amount`	`string`		The amount the customer receives, if known. Set the amount on either `source` or `destination`, not both.
`wallet`	`object`		Where the crypto is sent. Required for the quote to be `executable`.
`wallet.address`	`string`	✅	The destination wallet address.
`wallet.tag`	`string`		An optional memo or destination tag, used by some blockchains such as XRP or XLM.
`paymentMethod`	`object`		The payment method to quote against. Required for the quote to be `executable`.
`paymentMethod.type`	`string`	✅	The payment method type. See the Get a quote API reference for supported values.
`paymentMethod.id`	`string`		The stored payment method ID. Required when `type` is `"card"` to identify the specific card.
`feeBehavior`	`string`		How fees relate to `source.amount`. One of `"inclusive"` or `"exclusive"`. Defaults to `"inclusive"`. Only applies when you quote by `source.amount`; it is ignored when you quote by `destination.amount`.

This method does not require a separate auth token. The client uses stored credentials from an active connection.

Payment method types

paymentMethod.type accepts the payment methods available to the connected customer, including bank transfers. See the Get a quote API reference for the full list.

`type`	Payment method
`apple_pay`	Apple Pay
`google_pay`	Google Pay
`card`	Stored card
`sepa`	SEPA bank transfer

The fiat currencies each method supports come from getPaymentMethods (capabilities.supportedCurrencies); sepa is EUR only. For bank transfers, quote with paymentMethod.type set to "sepa" (EUR), then execute the quote with the same headless Buy frame you use for cards. See Bank transfer. Bank transfers are a floating payment method: the quote is an estimate, and the exact amount is set when the customer’s funds settle. Bank-transfer quotes return exchangeRateType: "floating"; card and wallet methods return exchangeRateType: "fixed". When exchangeRateType is "floating", render the estimated crypto amount with a tilde (for example, ~0.2345 BTC) and tell the customer the final amount is set when the transfer settles. See Exchange rate type.

Quote for a SEPA bank transfer

const quoteResult = await client.getQuote({
  source: { asset: { code: "EUR" }, amount: "100.00" },
  destination: { asset: { code: "ETH" } },
  wallet: { address: "0x1234567890123456789012345678901234567890" },
  paymentMethod: { type: "sepa" },
});

Bank transfers don’t support DeFi assets. A DeFi asset is a destination.asset identified by caip19. If you request a bank-transfer quote (sepa) for one, the request fails with 400 and the message “Bank transfers are not supported for DeFi assets.” Offer a card or wallet payment method for these assets instead.

Fee behavior

feeBehavior controls whether fees are taken out of source.amount or added on top of it. It only applies when you quote by source.amount.

"inclusive" (default): the customer pays exactly source.amount, and fees are carved out of it. Less of the source amount is converted, so the customer receives less crypto. This is the existing behavior, so omitting feeBehavior keeps quotes unchanged.
"exclusive": fees are added on top of source.amount, so the customer pays source.amount plus fees. The full source.amount is converted, so the customer receives more crypto than the inclusive quote for the same input.

When you quote by destination.amount, MoonPay ignores feeBehavior and the quote is always fees-inclusive. The response always echoes the effective feeBehavior: the value you requested for source-amount quotes, or "inclusive" for destination-amount quotes.

Quote with fees added on top

const quoteResult = await client.getQuote({
  source: { asset: { code: "USD" }, amount: "100.00" },
  destination: { asset: { code: "ETH" } },
  wallet: { address: "0x1234567890123456789012345678901234567890" },
  paymentMethod: { type: "apple_pay" },
  feeBehavior: "exclusive",
});

Result

client.getQuote() returns a Result<{ data: Quote }, GetQuoteError>.

Result envelope

Result<{ data: Quote }, GetQuoteError>

Field	Type	Required	Description
`ok`	`boolean`	✅	Whether the operation succeeded.
`value`	`{ data:` `Quote` `}`		Present when `ok` is `true`.
`error`	`GetQuoteError`		Present when `ok` is `false`.

`Quote`

A quote includes a signature you use to execute a transaction, plus fees and limits. See the API reference for the full shape.

Field	Type	Required	Description
`signature`	`string`	✅	A stringified JSON object that contains quote data and an embedded hash. Don’t deserialize this value. Use it as-is to execute a transaction.
`expiresAt`	`string`	✅	An ISO 8601 timestamp for when the quote expires.
`source`	`object`	✅	The source (fiat) asset details.
`destination`	`object`	✅	The destination (crypto) asset details.
`wallet`	`object`	✅	The destination wallet details.
`fees`	`object`	✅	Fee details for the transaction.
`feeBehavior`	`string`	✅	The effective fee behavior for this quote, `"inclusive"` or `"exclusive"`. Echoes the requested value for source-amount quotes, or `"inclusive"` for destination-amount quotes.
`executable`	`boolean`	✅	Whether the quote can be used to execute a transaction. See the API reference for the request fields required to receive `executable: true`.
`exchangeRate`	`string`	✅	The rate used to convert between fiat and crypto, as the fiat value of one unit of crypto. Pairs with `exchangeRateType`.
`exchangeRateType`	`string`	✅	`"fixed"` when the exchange rate is locked at quote time (card/wallet), or `"floating"` when it’s an estimate confirmed at settlement (bank transfers such as SEPA). Pairs with the `exchangeRate` field. See Exchange rate type.
`challenge`	`object`		Present when the customer must clear a step before this quote can be executed. Carries `kind` and `url`. Mount the challenge frame at `url`, then request the quote again. See Upgrade a guest account.

Exchange rate type

exchangeRateType tells you whether the quoted amount is final or an estimate, and pairs with the exchangeRate field. Bank transfers (SEPA) are a floating payment method: the quote is an estimate, and the exact amount is confirmed when the customer’s funds settle. These quotes return exchangeRateType: "floating". Card and wallet methods lock the rate at quote time and return exchangeRateType: "fixed". When exchangeRateType is "floating", render the estimated crypto amount with a tilde (for example, ~0.2345 BTC) and tell the customer the final amount is set when the transfer settles. When it is "fixed", the quoted amount is final. Branch on exchangeRateType when you format the amount the customer receives, so floating quotes always render with a tilde:

Render the crypto amount

// Frontend: the customer receives the destination (crypto) amount
function formatCryptoAmount(quote: Quote): string {
  const amount = `${quote.destination.amount} ${quote.destination.asset.code}`;
  // Floating quotes stay estimates until the transfer settles, so flag them.
  return quote.exchangeRateType === "floating" ? `~${amount}` : amount;
}

// "~0.2345 BTC" for a SEPA quote; "0.2345 BTC" for a card or wallet quote

`GetQuoteError`

GetQuoteError is the standard MoonPay Platform API error shape, DevPlatformApiError.

Field	Type	Required	Description
`code`	`DevPlatformApiErrorCode`	✅	A machine-readable error code (for example, `"invalid_request"`, `"unauthorized"`, `"unprocessable_entity"`). See the error reference for the full list.
`message`	`string`	✅	A developer-friendly message.
`errors`	`DevPlatformApiErrorDetail[]`		Optional list of field-level errors when the request fails validation. Each entry has a `field` and `message`.

TS Definition

types.ts

type DevPlatformApiErrorCode =
  | "unknown_error"
  | "unauthorized"
  | "forbidden"
  | "not_found"
  | "invalid_request"
  | "not_implemented"
  | "too_many_requests"
  | "not_allowed"
  | "conflict"
  | "unprocessable_entity"
  | "sse_timeout"
  | "sse_error"
  | "service_unavailable"
  | "requirements_incomplete"
  | "verification_rejected"
  | "country_mismatch"
  | "unsupported_country";

type DevPlatformApiErrorDetail = {
  field?: string;
  message: string;
};

type GetQuoteError = {
  code: DevPlatformApiErrorCode;
  message: string;
  errors?: DevPlatformApiErrorDetail[];
};

Overview

Customers

Payments

Integration essentials

SDK Reference

Frames

Parameters

Payment method types

Fee behavior

Result

Result envelope

`Quote`

Exchange rate type

`GetQuoteError`

​Parameters

​Payment method types

​Fee behavior

​Result

​Result envelope

​Quote

​Exchange rate type

​GetQuoteError

Parameters

Payment method types

Fee behavior

Result

Result envelope

`Quote`

Exchange rate type

`GetQuoteError`