> ## Documentation Index
> Fetch the complete documentation index at: https://dev.moonpay.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Sell quote
> Returns a set of key-value pairs representing a real-time sell quote for a currency. Supply the currency code, the base amount, your extra fee percentage, the payment method and whether the base amount is inclusive of fees, and MoonPay will return a detailed sell quote.
## OpenAPI
````yaml GET /v3/currencies/{currencyCode}/sell_quote
openapi: 3.0.0
info:
title: Ramps & Swaps
version: 1.0.0
servers:
- url: https://api.moonpay.com
security: []
tags:
- name: Account details
description: >-
Get your account details, including the verification status and the
current fees.
- name: On-ramp
description: Get quotes and transaction details for buying cryptocurrencies.
- name: Off-ramp
description: Get quotes and transaction details for selling cryptocurrencies.
- name: Swaps
description: Get quotes and transaction details for swapping cryptocurrencies.
- name: Data
description: >-
Get currently supported countries, currencies, and payment methods. Also
check the customers's IP address restrictions.
- name: DefiToken
description: Retrieve token data and token lists for DeFi assets.
paths:
/v3/currencies/{currencyCode}/sell_quote:
get:
tags:
- Off-ramp
summary: Get Sell quote
description: >-
Returns a set of key-value pairs representing a real-time sell quote for
a currency. Supply the currency code, the base amount, your extra fee
percentage, the payment method and whether the base amount is inclusive
of fees, and MoonPay will return a detailed sell quote.
operationId: getSellQuote
parameters:
- name: currencyCode
in: path
schema:
type: string
example: eth
description: >-
The code of the cryptocurrency from the currencies list
required: true
- name: query
in: query
style: form
explode: true
required: true
schema:
type: object
properties:
quoteCurrencyCode:
type: string
example: usd
description: >-
The code of the fiat currency from the currencies list
baseCurrencyAmount:
type: number
example: 3
description: >-
A positive number representing how much crypto the user wants
to sell. Up to 5 decimal digits are supported.
extraFeePercentage:
type: integer
example: 1
description: >-
A positive integer representing your extra fee percentage for
the transaction. The minimum is 0
and the maximum is 10. If you don't
provide it, we'll use the default value set to your account.
payoutMethod:
$ref: '#/components/schemas/PaymentMethods'
responses:
'200':
description: Successful response — Sell Quote
content:
application/json:
schema:
$ref: '#/components/schemas/SellQuote'
type: object
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- apiKey: []
components:
schemas:
PaymentMethods:
type: string
example: credit_debit_card
enum:
- ach_bank_transfer
- credit_debit_card
- paypal
- gbp_bank_transfer
- gbp_open_banking_payment
- pix_instant_payment
- sepa_bank_transfer
description: The transaction's payment method.
SellQuote:
type: object
properties:
quoteCurrencyCode:
type: string
example: eur
description: Fiat currency the customer wants to get.
quoteCurrency:
$ref: '#/components/schemas/FiatCurrency'
baseCurrencyCode:
type: string
example: btc
description: Crypto currency the customer wants to sell.
baseCurrency:
$ref: '#/components/schemas/CryptoCurrency'
baseCurrencyAmount:
type: number
example: 0.575
description: A positive number representing how much the customer wants to sell.
quoteCurrencyAmount:
type: number
example: 1521.11
description: >-
A positive number representing the amount of cryptocurrency the
customer will receive.
baseCurrencyPrice:
type: number
example: 45677.965840087985
description: The price of the crypto the customer wants to sell
feeAmount:
type: number
example: 15.36
description: A positive number representing the fee for the transaction.
extraFeeAmount:
type: number
example: 0
description: A positive number representing your extra fee for the transaction.
payoutMethod:
type: string
example: credit_debit_card
description: >-
The transaction's payout method. Possible values are
`credit_debit_card`, `ach_bank_transfer`, `paypal`,
`sepa_bank_transfer`, and `gbp_bank_transfer` .
enum:
- ach_bank_transfer
- credit_debit_card
- paypal
- gbp_bank_transfer
- sepa_bank_transfer
signature:
type: string
nullable: true
description: The signature for executing the quote for fixed flow
example: really-long-string
expiresIn:
type: number
nullable: true
example: 1800
description: The time in seconds until the quote expires.
expiresAt:
type: string
nullable: true
example: '2024-02-23T00:58:26.577Z'
description: Time at which the quote expires. Returned as an ISO 8601 string.
Error:
type: object
properties:
message:
type: string
description: A descriptive error message.
type:
type: string
description: An error type.
FiatCurrency:
type: object
properties:
id:
type: string
description: Unique identifier for the currency.
example: 6f424585-8936-4eb1-b01e-443fb306d1f5
createdAt:
type: string
description: >-
Time at which the object was created. Returned as an ISO 8601
string.
example: '2019-05-17T18:24:45.206Z'
updatedAt:
type: string
description: >-
Time at which the object was last updated. Returned as an ISO 8601
string.
example: '2019-05-17T18:24:45.206Z'
type:
type: string
enum:
- fiat
description: Always `fiat`
example: fiat
name:
type: string
description: The currency's name.
example: Pound Sterling
code:
type: string
description: The currency's code.
example: gbp
precision:
type: number
description: The currency's precision (number of digits after decimal point).
example: 2
minBuyAmount:
type: number
nullable: true
description: >-
Represents the minimum transaction buy amount when using this
currency as a base currency.
example: 30
maxBuyAmount:
type: number
nullable: true
description: >-
Represents the maximum transaction buy amount when using this
currency as a base currency.
example: 9000
isSellSupported:
type: boolean
description: Whether sales for this currency are supported.
example: true
CryptoCurrency:
type: object
properties:
id:
type: string
description: Unique identifier for the currency.
example: aaefa32f-161b-42c8-8115-debcbf3d6a2d
createdAt:
type: string
description: >-
Time at which the object was created. Returned as an ISO 8601
string.
example: '2019-05-17T18:24:45.206Z'
updatedAt:
type: string
description: >-
Time at which the object was last updated. Returned as an ISO 8601
string.
example: '2019-05-17T18:24:45.206Z'
type:
type: string
enum:
- crypto
description: Always `crypto`
example: crypto
name:
type: string
description: The currency's name.
example: USD Coin (ERC-20)
code:
type: string
description: The currency's code.
example: usdc
precision:
type: number
description: The currency's precision (number of digits after decimal point).
example: 2
minBuyAmount:
type: number
nullable: true
description: Represents the minimum amount of cryptocurrency you can buy.
example: 30
maxBuyAmount:
type: number
nullable: true
description: Represents the maximum amount of cryptocurrency you can buy.
example: 1000
minSellAmount:
type: number
nullable: true
description: The minimum amount of cryptocurrency you can sell.
example: 15
maxSellAmount:
type: number
nullable: true
description: The maximum amount of cryptocurrency you can sell.
example: 100000
addressRegex:
type: string
description: >-
A regular expression which you can test against your end user's
wallet addresses.
example: ^(0x)[0-9A-Fa-f]{40}$
testnetAddressRegex:
type: string
description: >-
A regular expression which you can test against your end user's
testnet wallet addresses.
example: ^(0x)[0-9A-Fa-f]{40}$
supportsAddressTag:
type: boolean
description: Whether the currency supports address tags.
example: false
addressTagRegex:
type: string
nullable: true
description: >-
A regular expression which you can test against a wallet address
tag. Defined only if the currency supports address tags.
example: null
supportsTestMode:
type: boolean
description: Whether the currency supports test mode.
example: true
isSuspended:
type: boolean
description: >-
Whether purchases for this currency are suspended. If the currency
is suspended, exchange rates may not be available and it is not
possible to create a transaction with this currency.
example: false
isSupportedInUs:
type: boolean
description: Whether purchases for this currency are supported in the US.
example: true
isSellSupported:
type: boolean
description: Whether sales for this currency are supported.
example: true
notAllowedUSStates:
type: array
items:
type: string
enum:
- AL
- AK
- AZ
- AR
- AS
- CA
- CO
- CT
- DC
- DE
- FL
- GA
- GU
- HI
- ID
- IL
- IN
- IA
- KS
- KY
- LA
- MA
- MD
- ME
- MI
- MN
- MO
- MP
- MS
- MT
- NE
- NH
- NV
- NH
- NJ
- NM
- NY
- NC
- ND
- OH
- OK
- OR
- PA
- PR
- RI
- SC
- SD
- TN
- TX
- TT
- UT
- VT
- VA
- VI
- WA
- WV
- WI
- WY
description: >-
A list with all the US states for this currency that are not
supported.
example:
- LA
- VI
notAllowedCountries:
type: array
items:
type: string
description: >-
A list with all the ISO 3166-1 alpha-2 country codes for this
currency that are not supported.
example:
- CA
metadata:
type: object
description: Additional metadata for the currency.
properties:
contractAddress:
type: string
nullable: true
description: >-
Unique contract address where the token smart contract is
hosted.
example: 0
chainId:
type: string
nullable: true
description: ID used to identify different EVM compatible chains.
example: '1'
networkCode:
type: string
description: Name of the cryptocurrency
example: ethereum
securitySchemes:
apiKey:
type: apiKey
name: apiKey
in: query
````