Get Real-time Buy quote - MoonPay Developer Docs

{ "accountId": "717a8a80-5c17-46f9-84f8-a5253c372f51", "baseCurrency": { "id": "6f424585-8936-4eb1-b01e-443fb306d1f5", "createdAt": "2019-05-17T18:24:45.206Z", "updatedAt": "2019-05-17T18:24:45.206Z", "type": "fiat", "name": "Pound Sterling", "code": "gbp", "precision": 2, "minBuyAmount": 30, "maxBuyAmount": 9000, "isSellSupported": true }, "baseCurrencyCode": "usd", "baseCurrencyAmount": 288.37, "quoteCurrency": { "id": "aaefa32f-161b-42c8-8115-debcbf3d6a2d", "createdAt": "2019-05-17T18:24:45.206Z", "updatedAt": "2019-05-17T18:24:45.206Z", "type": "crypto", "name": "USD Coin (ERC-20)", "code": "usdc", "precision": 2, "minBuyAmount": 30, "maxBuyAmount": 1000, "minSellAmount": 15, "maxSellAmount": 100000, "addressRegex": "^(0x)[0-9A-Fa-f]{40}$", "testnetAddressRegex": "^(0x)[0-9A-Fa-f]{40}$", "supportsAddressTag": false, "addressTagRegex": null, "supportsTestMode": true, "isSuspended": false, "isSupportedInUs": true, "isSellSupported": true, "notAllowedUSStates": [ "LA", "VI" ], "notAllowedCountries": [ "CA" ], "metadata": { "contractAddress": 0, "chainId": "1", "networkCode": "ethereum" } }, "quoteCurrencyCode": "btc", "quoteCurrencyAmount": 0.0055, "quoteCurrencyPrice": 52474.5036, "paymentMethod": "credit_debit_card", "feeAmount": 3.99, "extraFeePercentage": 0, "extraFeeAmount": 0, "networkFeeAmount": 7.64, "networkFeeAmountNonRefundable": false, "totalAmount": 300, "externalId": null, "externalCustomerId": null, "signature": "really-long-string", "expiresIn": 1800, "expiresAt": "2024-02-23T00:58:26.577Z" }

Authorizations

apiKey

string

query

required

Path Parameters

currencyCode

string

required

The code of the cryptocurrency of interest from the currencies list with type=crypto

Query Parameters

query

object

required

Show child attributes

Response

Successful response — Buy Quote

accountId

string

ID of your business account

Example:

"717a8a80-5c17-46f9-84f8-a5253c372f51"

baseCurrency

object

The fiat currency the customer wants to use for the transaction.

Show child attributes

baseCurrencyCode

string

Example:

"usd"

baseCurrencyAmount

number

A positive number representing how much the customer wants to spend. The minimum amount is 20.

Example:

288.37

quoteCurrency

object

The cryptocurrency the customer wants to purchase.

Show child attributes

quoteCurrencyCode

string

Example:

"btc"

quoteCurrencyAmount

number

A positive number representing the amount of cryptocurrency the customer will receive. Set when the purchase of cryptocurrency has been executed.

Example:

0.0055

quoteCurrencyPrice

number

The price of the crypto the customer will receive

Example:

52474.5036

paymentMethod

enum<string>

The transaction's payment method.

Available options:

ach_bank_transfer,

credit_debit_card,

paypal,

gbp_bank_transfer,

gbp_open_banking_payment,

pix_instant_payment,

sepa_bank_transfer

Example:

"credit_debit_card"

feeAmount

number

A positive number representing the fee for the transaction.

Example:

3.99

extraFeePercentage

number

Example:

0

extraFeeAmount

number

Example:

0

networkFeeAmount

number

A positive number representing the network fee for the transaction. It is added to baseCurrencyAmount, feeAmount and extraFeeAmount when the customer's card is charged.

Example:

7.64

networkFeeAmountNonRefundable

boolean

Example:

false

totalAmount

number

Example:

300

externalId

string | null

Example:

null

externalCustomerId

string | null

Example:

null

signature

string | null

The signature for executing the quote for fixed flow

Example:

"really-long-string"

expiresIn

number | null

The time in seconds until the quote expires.

Example:

1800

expiresAt

string | null

Time at which the quote expires. Returned as an ISO 8601 string.

Example:

"2024-02-23T00:58:26.577Z"