---
title: "Get buy quote"
method: GET
path: "/v1/quote/buy"
tags: ["Quote"]
---

# Get buy quote

`GET /v1/quote/buy`

Returns a real-time buy quote for a currency pair.
Supply `quoteCurrencyCode`, `baseCurrencyCode`, and `quoteCurrencyAmount` (fiat amount) to get a
detailed buy quote including fees and the amount of crypto the user will receive.

## Query parameters

- `quoteCurrencyCode` string, required
- `baseCurrencyCode` string, required
- `quoteCurrencyAmount` number, required
- `paymentMethod` 'CARD' | 'APPLE_PAY' | 'GOOGLE_PAY' | 'BANK_TRANSFER_NIP' — Payment method to be used for the order.
- `countryCode` string
- `usStateCode` string
- `walletAddress` string

## Response `200`

Buy quote with price, fees, and resulting crypto amount.

- object
  - `quoteCurrencyAmount` string, required — The fiat amount the user pays for the transaction.
  - `quoteCurrencyCode` string, required — The fiat currency being spent.
  - `quoteCurrency` Currency, required
    - `type` 'FIAT' | 'CRYPTO', required — Whether this is a fiat or crypto currency.
    - `name` string, required — Full name of the currency.
    - `code` string, required — Alphabetical ticker code for the currency. Case sensitive.
    - `precision` integer, required — Number of decimal places supported. For example, BTC has precision 8 (smallest unit 0.00000001 BTC).
    - `minBuyAmount` string — Minimum fiat amount allowed per order. Only present for fiat currencies.
    - `maxBuyAmount` string — Maximum fiat amount allowed per order. Only present for fiat currencies.
    - `network` string — The blockchain network the currency runs on (e.g. BTC, ETH). Always null for fiat.
    - `supportsDestinationTag` boolean — Whether the currency supports destination tags or memo fields (e.g. XLM, XRP). Always null for fiat.
    - `isSupportedInUS` boolean — Whether purchases of this currency are supported in the US. Always null for fiat.
    - `allowedUSStates` string[] — US states where this currency can be purchased, using the last 2 characters of ISO 3166-2:US codes. Always null for fiat.
  - `baseCurrencyAmount` string, required — The amount of crypto converted from `quoteCurrencyAmount` at `price`, before fees. See `totalAmount` for the net amount after fees.
  - `baseCurrencyCode` string, required — The crypto currency being purchased.
  - `baseCurrency` Currency, required
    - `type` 'FIAT' | 'CRYPTO', required — Whether this is a fiat or crypto currency.
    - `name` string, required — Full name of the currency.
    - `code` string, required — Alphabetical ticker code for the currency. Case sensitive.
    - `precision` integer, required — Number of decimal places supported. For example, BTC has precision 8 (smallest unit 0.00000001 BTC).
    - `minBuyAmount` string — Minimum fiat amount allowed per order. Only present for fiat currencies.
    - `maxBuyAmount` string — Maximum fiat amount allowed per order. Only present for fiat currencies.
    - `network` string — The blockchain network the currency runs on (e.g. BTC, ETH). Always null for fiat.
    - `supportsDestinationTag` boolean — Whether the currency supports destination tags or memo fields (e.g. XLM, XRP). Always null for fiat.
    - `isSupportedInUS` boolean — Whether purchases of this currency are supported in the US. Always null for fiat.
    - `allowedUSStates` string[] — US states where this currency can be purchased, using the last 2 characters of ISO 3166-2:US codes. Always null for fiat.
  - `price` string, required — The buy-side price of the base currency denominated in the quote currency.
  - `processingFeeAmount` string, required — Blockchain.com processing fee denominated in the quote (fiat) currency.
  - `partnerFeeAmount` string, required — Partner fee denominated in the quote (fiat) currency.
  - `networkFeeAmount` string, required — Network (blockchain transaction) fee denominated in the quote (fiat) currency.
  - `totalAmount` string, required — Net amount of crypto the user receives after all fees.
  - `paymentMethod` 'CARD' | 'APPLE_PAY' | 'GOOGLE_PAY' | 'BANK_TRANSFER_NIP' — Payment method to be used for the order.

## Other responses

- `default` — Returns 400 when: 1. Any required query parameter is missing. 2. `baseCurrencyCode` or `quoteCurrencyCode` is not supported. 3. `baseCurrencyCode` is not of type CRYPTO. 4. `quoteCurrencyCode` is not of type FIAT. 5. `baseCurrencyCode` is not allowed for trading in the given `countryCode`. 6. `baseCurrencyCode` is not allowed for trading in the given `usStateCode`. 7. `quoteCurrencyCode` is not allowed for any region. 8. `baseCurrencyCode` is not allowed for any region. Returns 422 when: 1. Fee profile for partner not found. 2. Quote not available for the requested parameters.

---

[API](https://skmtc.net/blockchain/apis/blockchain-com-pay-partner-api.md) · [All operations](https://skmtc.net/blockchain/apis/blockchain-com-pay-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockchain/blockchain-com-pay-partner-api/revisions/7579ec027be7/schema)