> ## 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                                              |
| `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                        |

## 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,
  "signature": "eyJhbGciOiJIUzI1NiIs...",
  "paymentDisclosures": [
    {
      "id": "eea-crypto-asset-risk",
      "version": "1"
    }
  ]
}
```