{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/meld/json-schema/meld-crypto-quote-request-schema.json",
  "title": "CryptoQuoteRequest",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/meld-retail-ramp-api-openapi.yml#/components/schemas/CryptoQuoteRequest",
  "type": "object",
  "properties": {
    "countryCode": {
      "type": "string",
      "description": "Two-letter country code (ISO 3166-1 alpha-2)",
      "default": "US"
    },
    "customerId": {
      "type": "string",
      "description": "Meld generated unique identifier for your customer. This should be used to track customer activity."
    },
    "destinationCurrencyCode": {
      "type": "string",
      "description": "Enter a cryptocurrency symbol here if purchasing crypto or a fiat currency 3 letter code if selling crypto.",
      "minLength": 1,
      "default": "BTC"
    },
    "externalCustomerId": {
      "type": "string",
      "description": "Your unique identifier for your customer. If maintaining your own customer management system this can also be used for tracking customer activity."
    },
    "paymentMethodType": {
      "type": "string",
      "description": "Payment Method Type or SubType\n\nThe paymentMethodType and paymentMethodSubType included here are a sample set. Review the [Supported Payment Methods](https://www.meld.io/coverage/payment-methods) section to view the complete list."
    },
    "serviceProviders": {
      "type": "array",
      "description": "An optional list of Strings representing the Service Providers for this Quote.\n\nReference [Crypto supported service providers](https://www.meld.io/coverage/service-providers) for a full list of supported service providers\n\nIf 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.",
      "items": {
        "type": "string",
        "enum": [
          "ACROSS",
          "AEROPAY",
          "AKOYA",
          "ALCHEMYPAY",
          "APPLEPAY",
          "AUTHORIZENET",
          "BANXA",
          "BILIRA",
          "BINANCECONNECT",
          "BINANCEPAY",
          "BLOCKCHAINDOTCOM",
          "BOOMFI",
          "BRAINTREE",
          "BRALE",
          "BTCDIRECT",
          "CASHAPP",
          "CHECKOUT",
          "CIRCLE",
          "COINBASEPAY",
          "COINFLOW",
          "DUENETWORK",
          "ELDORADO",
          "FINICITY",
          "FLASHNET",
          "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",
          "UPHOLD",
          "WYRE",
          "XANPOOL",
          "YELLOWCARD",
          "YODLEE"
        ]
      }
    },
    "sourceAmount": {
      "type": "number",
      "description": "The source amount for this transaction.",
      "minimum": 0.0,
      "default": 100
    },
    "sourceCurrencyCode": {
      "type": "string",
      "description": "Enter a fiat currency 3 letter code here if purchasing crypto or a cryptocurrency symbol if selling crypto.",
      "minLength": 1,
      "default": "USD"
    },
    "subdivision": {
      "type": "string",
      "description": "subdivision is a optional parameter Only applicable if the country code is US or CA."
    },
    "walletAddress": {
      "type": "string",
      "description": "Your customer's wallet address"
    }
  },
  "required": [
    "countryCode",
    "destinationCurrencyCode",
    "sourceAmount",
    "sourceCurrencyCode"
  ]
}