Get Real-time Buy quote

curl --request GET \
  --url 'https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey='

const options = {method: 'GET'};

fetch('https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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": "0x0000000000000000000000000000000000000000",
      "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"
}

{
  "moonPayErrorCode": "4_SYS_BAD_REQUEST",
  "message": "<string>",
  "type": "<string>",
  "errors": [
    {
      "property": "<string>",
      "message": "<string>",
      "children": [
        {}
      ]
    }
  ]
}

{
  "moonPayErrorCode": "4_SYS_BAD_REQUEST",
  "message": "<string>",
  "type": "<string>",
  "errors": [
    {
      "property": "<string>",
      "message": "<string>",
      "children": [
        {}
      ]
    }
  ]
}

{
  "moonPayErrorCode": "4_SYS_BAD_REQUEST",
  "message": "<string>",
  "type": "<string>",
  "errors": [
    {
      "property": "<string>",
      "message": "<string>",
      "children": [
        {}
      ]
    }
  ]
}

GET

currencies

{currencyCode}

buy_quote

Get Real-time Buy quote

curl --request GET \
  --url 'https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey='

const options = {method: 'GET'};

fetch('https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.moonpay.com/v3/currencies/{currencyCode}/buy_quote?apiKey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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": "0x0000000000000000000000000000000000000000",
      "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"
}

{
  "moonPayErrorCode": "4_SYS_BAD_REQUEST",
  "message": "<string>",
  "type": "<string>",
  "errors": [
    {
      "property": "<string>",
      "message": "<string>",
      "children": [
        {}
      ]
    }
  ]
}

{
  "moonPayErrorCode": "4_SYS_BAD_REQUEST",
  "message": "<string>",
  "type": "<string>",
  "errors": [
    {
      "property": "<string>",
      "message": "<string>",
      "children": [
        {}
      ]
    }
  ]
}

{
  "moonPayErrorCode": "4_SYS_BAD_REQUEST",
  "message": "<string>",
  "type": "<string>",
  "errors": [
    {
      "property": "<string>",
      "message": "<string>",
      "children": [
        {}
      ]
    }
  ]
}

Authorizations

apiKey

string

query

required

Your publishable API key, passed as the apiKey query parameter. Publishable keys are prefixed with pk_test_ (sandbox) or pk_live_ (production) and are safe to use in client-side code. Find your keys on the API keys page of the dashboard. See Authentication.

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"

Overview

Customers

On-ramp

Off-ramp

Data

DeFi tokens

Virtual Accounts

Webhooks

Get Real-time Buy quote

Authorizations

Path Parameters

Query Parameters

Response