> ## Documentation Index
> Fetch the complete documentation index at: https://dev.moonpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quote

> A quote for a buy transaction with locked rate, fees, and expiry

## Properties

| Property             | Type                                                               | Required | Description                                                                            |
| -------------------- | ------------------------------------------------------------------ | -------- | -------------------------------------------------------------------------------------- |
| `source`             | object                                                             | Yes      | Source amount and asset (fiat currency) you send                                       |
| `destination`        | object                                                             | Yes      | Destination amount and asset (cryptocurrency) the customer receives                    |
| `fees`               | [Fees](/api-reference/platform/objects-and-types/fees)             | Yes      | Breakdown of network, MoonPay, and ecosystem fees                                      |
| `wallet`             | [Wallet](/api-reference/platform/objects-and-types/wallet) \| null | Yes      | Wallet address where crypto will be sent. Null if not yet provided                     |
| `paymentMethod`      | object \| null                                                     | Yes      | Payment method used for this quote. Null if not specified                              |
| `expiresAt`          | string (date-time)                                                 | Yes      | ISO 8601 datetime when the quote expires                                               |
| `executable`         | boolean                                                            | Yes      | Whether the quote can be executed                                                      |
| `feeBehavior`        | string                                                             | Yes      | Effective fee behavior, `inclusive` or `exclusive`. See [Fee behavior](#fee-behavior). |
| `signature`          | string                                                             | Yes      | Signature for mounting a payment frame                                                 |
| `paymentDisclosures` | array                                                              | No       | Disclosure(s) to render for this transaction. Empty array means none required.         |

## Source / Destination

Both `source` and `destination` have the same structure:

| Property | Type                                                     | Required | Description                                  |
| -------- | -------------------------------------------------------- | -------- | -------------------------------------------- |
| `amount` | string                                                   | Yes      | The amount as a string to preserve precision |
| `asset`  | [Asset](/api-reference/platform/objects-and-types/asset) | Yes      | The currency or token                        |

## Fee behavior

`feeBehavior` describes how fees relate to `source.amount` when you request a quote by `source.amount`:

* `inclusive` (default): the customer pays exactly `source.amount`, and fees are carved out of it.
* `exclusive`: fees are added on top of `source.amount`. The full `source.amount` is converted, so the customer receives more crypto than the inclusive quote for the same input.

Set `feeBehavior` on the buy-quote request to choose the behavior. It applies only to source-amount quotes. When you quote by `destination.amount`, MoonPay ignores the request value and the quote is always fees-inclusive. The response always echoes the effective `feeBehavior`.

## Using the Quote

Pass the `signature` to the payment frame when you mount it. The frame uses this signature along with the quote data to execute the payment and create the transaction.

<Warning>
  Quotes expire. Check `expiresAt` and create the transaction before this time.
  If `executable` is `false`, the customer must provide additional information
  before you can use this quote.
</Warning>

## Payment disclosures

Each item in `paymentDisclosures` identifies a specific piece of text you must render verbatim.

| Property  | Type   | Description                                                                                                                                                                              |
| --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`      | string | Identifies a specific disclosure. See the ID table below.                                                                                                                                |
| `version` | string | Increments on any wording change. If you receive an unrecognised `version`, fall back to the most-conservative disclosure and log an alert so your integration team can update the copy. |

### Disclosure IDs

| ID                                | Description                                                                                                                                                   |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `us-transaction-finality`         | Required in NY and WA (NYDFS / state money-transmitter rules). See [disclosure copy](/platform/overview/going-live#disclosures---us-new-york-and-washington). |
| `eea-crypto-asset-risk`           | EEA standard crypto-asset risk disclosure (MiCA)                                                                                                              |
| `eea-unregulated-stablecoin-risk` | EEA disclosure for non-MiCA-compliant stablecoins (USDT, DAI, PYUSD)                                                                                          |

## Example

```json theme={null}
{
  "source": {
    "amount": "100.00",
    "asset": {
      "code": "USD",
      "name": "US Dollar",
      "precision": 2
    }
  },
  "destination": {
    "amount": "0.0025",
    "asset": {
      "code": "ETH",
      "name": "Ethereum",
      "precision": 18
    }
  },
  "fees": {
    "network": {
      "amount": "2.50",
      "currencyCode": "USD"
    },
    "moonpay": {
      "amount": "3.99",
      "currencyCode": "USD"
    }
  },
  "wallet": {
    "address": "0x1234...abcd"
  },
  "paymentMethod": {
    "type": "apple_pay"
  },
  "expiresAt": "2026-01-29T14:35:50.000Z",
  "executable": true,
  "feeBehavior": "inclusive",
  "signature": "eyJhbGciOiJIUzI1NiIs...",
  "paymentDisclosures": [
    {
      "id": "eea-crypto-asset-risk",
      "version": "1"
    }
  ]
}
```