Skip to main content
POST
/
platform
/
v1
/
quotes
/
buy
Build a buy quote
curl --request POST \
  --url https://api.moonpay.com/platform/v1/quotes/buy \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": {
    "asset": {
      "code": "USD"
    },
    "amount": "<string>"
  },
  "destination": {
    "asset": {
      "code": "<string>"
    },
    "amount": "<string>"
  },
  "wallet": {
    "address": "0x1234567890123456789012345678901234567890"
  }
}
'
{
  "data": {
    "source": {
      "amount": "<string>",
      "asset": {
        "code": "USD"
      }
    },
    "destination": {
      "amount": "<string>",
      "asset": {
        "code": "<string>",
        "name": "<string>",
        "precision": 123
      }
    },
    "fees": {
      "network": {
        "amount": "2.39",
        "asset": {
          "code": "USD"
        }
      },
      "moonpay": {
        "amount": "4.99",
        "asset": {
          "code": "USD"
        }
      },
      "ecosystem": {
        "amount": "1.00",
        "asset": {
          "code": "USD"
        }
      }
    },
    "wallet": {
      "address": "0x1234567890123456789012345678901234567890"
    },
    "paymentMethod": {
      "id": "<string>"
    },
    "limits": {
      "daily": {
        "limit": {
          "amount": "<string>",
          "asset": {
            "code": "USD"
          }
        },
        "remaining": {
          "amount": "<string>",
          "asset": {
            "code": "USD"
          }
        }
      },
      "monthly": {
        "limit": {
          "amount": "<string>",
          "asset": {
            "code": "USD"
          }
        },
        "remaining": {
          "amount": "<string>",
          "asset": {
            "code": "USD"
          }
        }
      },
      "yearly": {
        "limit": {
          "amount": "<string>",
          "asset": {
            "code": "USD"
          }
        },
        "remaining": {
          "amount": "<string>",
          "asset": {
            "code": "USD"
          }
        }
      }
    },
    "expiresAt": "2023-11-07T05:31:56Z",
    "executable": true,
    "exchangeRate": "<string>",
    "paymentDisclosures": [
      {
        "id": "<string>",
        "version": "<string>"
      }
    ],
    "signature": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header using an access token.

Example: Authorization: Bearer <accessToken>

Body

application/json
​
source
object
required

Source asset in fiat. Amount can be set in source or destination.

Example:
{
  "amount": "100.02",
  "asset": { "code": "USD" }
}
​
destination
object
required

Destination asset in crypto. Amount can be set in destination or source.

​
wallet
object

Wallet address and optional tag where the crypto will be sent. Required for the quote to be executable.

Example:
{
  "address": "0x1234567890123456789012345678901234567890"
}
​
paymentMethod
object

Payment method for the transaction. Required for the quote to be executable.

Response

The request has succeeded.

​
data
object
required

Quote for a fiat-to-crypto buy. Contains locked rate, fees, expiry, and signature for payment execution.

Example:
{
  "source": {
    "amount": "100.00",
    "asset": { "code": "USD" }
  },
  "destination": {
    "amount": "0.00114",
    "asset": { "code": "BTC" }
  },
  "fees": {
    "network": {
      "amount": "2.39",
      "asset": { "code": "USD" }
    },
    "moonpay": {
      "amount": "4.99",
      "asset": { "code": "USD" }
    },
    "ecosystem": {
      "amount": "1.00",
      "asset": { "code": "USD" }
    }
  },
  "wallet": {
    "address": "0x1234567890123456789012345678901234567890"
  },
  "paymentMethod": {},
  "limits": null,
  "expiresAt": "2026-03-27T12:30:00.000Z",
  "executable": true,
  "exchangeRate": "87523.17",
  "paymentDisclosures": [
    {
      "id": "eea-crypto-asset-risk",
      "version": "1"
    }
  ],
  "signature": "cXVvdGUuc2lnbmF0dXJl..."
}