Quotes

Returns the quote for a specific fiat currency, amount and payment method

The Quotes API allows you to fetch real-time quotes for transactions across different fiat-to-crypto pairs. This information can be used to display quotes in your UI prior to redirecting them Blockchain.com Pay.

Note: Users may see a slightly different quote if it expires prior to them being redirected to Blockchain.com Pay

Get buy quote

get

Returns real-time buy quote for a currency pair. Supply quoteCurrencyCode, baseCurrencyCode and quoteCurrencyAmount(fiat) to get a detailed buy quote, comprehensive of fees, and the amount of quote currency (fiat) that the user will need to pay for the transaction, as well as base currency (crypto) the user will get after the transaction.

Authorizations

PublicApiKeyAuthPrivateApiKeyAuth

X-Public-API-KeystringRequired

Query parameters

quoteCurrencyCodestringRequired

The currency to buy with. Must be a fiat currency.

Example: USD

baseCurrencyCodestringRequired

The currency to buy. Must be crypto.

Example: BTC

quoteCurrencyAmountnumberRequired

A positive decimal representing how much crypto the customer wants to buy. Must be a decimal number with precision not higher then the currency precision.

Example: 100.00

paymentMethodstring · enumOptional

Payment method to be used for the order. If not set, the quote will not consider the payment method.

Possible values:

countryCodestring · min: 2 · max: 2Optional

e.g. US

Example: USPattern: Iso3188-1-alpha2

usStateCodestringOptional

e.g. AL. If country!=US this parameter is ignored.

Example: AL

walletAddressstringOptional

The wallet address where the user wants to receive the crypto.

Responses

200

ok

application/json

quoteCurrencyAmountstringRequired

The amount of quote currency (fiat) that the user will need to pay for the transaction

Example: 63.00

quoteCurrencyCodestringRequired

Currency the user is buying with.

Example: USD

baseCurrencyAmountstringRequired

The amount of base currency (crypto) that will be converted from quoteCurrencyAmount using price. It does not include fees. See totalAmount for the amount of base currency the user will get after the transaction (fees included)

Example: 0.001

baseCurrencyCodestringRequired

Currency the user is buying.

Example: BTC

pricestringRequired

The price of the base currency in the quote currency. If the customer is buying BTC with USD, this is the price of BTC in USD

Example: 62451.29

processingFeeAmountstringRequired

The amount of Blockchain.com processing fees expressed in quote currency. e.g. when buying BTC with USD, this fee is expressed in USD

Example: 1.00

partnerFeeAmountstringOptional

The amount of partner fees expressed in quote currency. e.g. when buying BTC with USD, this fee is expressed in USD

Example: 1.00

networkFeeAmountstringRequired

The amount of network (blockchain transaction) fees expressed in quote currency. e.g. when buying BTC with USD, this fee is expressed in USD

Example: 1.00

totalAmountstringRequired

The actual of the base currency (crypto) the user will get after the transaction, comprehensive of all fees. See baseCurrencyAmount for the amount without fees.

Example: 0.0009

paymentMethodall ofOptional

Payment method to be used for the order. Can be null if it was not provided in the request

Example: CARD

string · enumOptional

Payment method to be used for the order. Can be null if it was not provided in the request.

Example: CARDPossible values:

default

Returns error 400 when:

1. Any of the required query params are missing
2. baseCurrencyCode / quoteCurrencyCode is not supported
3. baseCurrencyCode is not of the type 'Crypto'
4. quoteCurrencyCode is not of the type 'Fiat'
5. baseCurrencyCode is not allowed for trading in this country
6. baseCurrencyCode is not allowed for trading in this usState
7. quoteCurrencyCode is not allowed for trading in this country
8. quoteCurrencyCode is not allowed for trading in this usState
9. quoteCurrencyCode is not allowed for any region
10. baseCurrencyCode is not allowed for any region Returns error 422 when:
11. Fee profile for partner not found
12. Quote not found for the requested parameters

application/json

get

/v1/quote/buy

HTTPcURLJavaScriptPython

GET /partner-gateway/partner-api/v1/quote/buy?quoteCurrencyCode=text&baseCurrencyCode=text&quoteCurrencyAmount=1 HTTP/1.1
Host: api.blockchain.info
X-Public-API-Key: YOUR_API_KEY
Accept: */*

{
  "quoteCurrencyAmount": "63.00",
  "quoteCurrencyCode": "USD",
  "quoteCurrency": [
    {
      "type": "FIAT",
      "name": "US Dollar",
      "code": "USD",
      "precision": 2,
      "minBuyAmount": 20,
      "maxBuyAmount": 1200
    }
  ],
  "baseCurrencyAmount": "0.001",
  "baseCurrencyCode": "BTC",
  "baseCurrency": [
    {
      "type": "CRYPTO",
      "name": "Bitcoin",
      "code": "BTC",
      "precision": 8,
      "network": "BTC",
      "supportsDestinationTag": false,
      "isSupportedInUS": true,
      "allowedUSStates": [
        "AL",
        "CT"
      ]
    }
  ],
  "price": "62451.29",
  "processingFeeAmount": "1.00",
  "partnerFeeAmount": "1.00",
  "networkFeeAmount": "1.00",
  "totalAmount": "0.0009",
  "paymentMethod": "CARD"
}