Skip to main content
POST
/
payments
/
virtual-account
/
quote
Create a crypto virtual account ramp quote
curl --request POST \
  --url https://api-sb.meld.io/payments/virtual-account/quote \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "countryCode": "US",
  "sourceAmount": 50
}
'
{
  "quotes": [
    {
      "countryCode": "<string>",
      "destinationAmount": 123,
      "destinationAmountWithoutFees": 123,
      "destinationCurrencyCode": "<string>",
      "exchangeRate": 123,
      "fiatAmountWithoutFees": 123,
      "networkFee": 123,
      "partnerFee": 123,
      "paymentMethodType": "<string>",
      "sourceAmount": 123,
      "sourceAmountWithoutFees": 123,
      "sourceCurrencyCode": "<string>",
      "totalFee": 123,
      "transactionFee": 123,
      "transactionType": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
default:BASIC <Meld API Key>
required

Body

application/json
countryCode
string
required

Two-letter country code (ISO 3166-1 alpha-2)

Example:

"US"

customerId
string
required

Customer id. Required for virtual account ramp quotes.

Minimum string length: 1
destinationCurrencyCode
string
required

Enter a cryptocurrency symbol here if purchasing crypto or a fiat currency 3 letter code if selling crypto.

Minimum string length: 1
paymentMethodType
string
required

Payment Method Type or SubType

The paymentMethodType and paymentMethodSubType included here are a sample set. Review the Supported Payment Methods section to view the complete list.

Minimum string length: 1
sourceAmount
number
required

The source amount for this transaction.

Required range: x >= 0
Example:

50

sourceCurrencyCode
string
required

Enter a fiat currency 3 letter code here if purchasing crypto or a cryptocurrency symbol if selling crypto.

Minimum string length: 1
serviceProviders
enum<string>[]

An optional list of Strings representing the Service Providers for this Quote.

Reference Crypto supported service providers for a full list of supported service providers

If this field is null or an empty list, Meld will get quotes from all the service providers linked to the API key used on the request.

Available options:
ACROSS,
AEROPAY,
AKOYA,
ALCHEMYPAY,
APPLEPAY,
AUTHORIZENET,
BANXA,
BILIRA,
BINANCECONNECT,
BINANCEPAY,
BLOCKCHAINDOTCOM,
BOOMFI,
BRAINTREE,
BRALE,
BTCDIRECT,
CASHAPP,
CHECKOUT,
CIRCLE,
COINBASEPAY,
COINFLOW,
DUENETWORK,
ELDORADO,
FINICITY,
FONBNK,
GUARDARIAN,
HARBOUR,
KOYWE,
KRYPTONIM,
MERCURYO,
MESH,
MESO,
MOONPAY,
MOOV,
MX,
NMI,
NOAH,
ONMETA,
ONRAMPMONEY,
PAYBIS,
PAYPAL,
PLAID,
RAMP,
REVOLUT,
ROBINHOOD,
ROUTERPROTOCOL,
SALTEDGE,
SALTEDGEPARTNERS,
SARDINE,
SHIFT4,
SHOPIFY,
SIMPLEX,
SKRILLCRYPTO,
SQUARE,
STRIPE,
SUMSUB,
SWAPPED,
TANGOCARD,
TELLER,
TOPPER,
TRANSAK,
TREMENDOUS,
TRANSFI,
UNLIMIT,
WYRE,
XANPOOL,
YELLOWCARD,
YODLEE
subdivision
string

subdivision is a optional parameter Only applicable if the country code is US or CA.

Response

OK

quotes
object[]

List of quotes