> ## 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 Swap quote > Returns the swap quote for a specific swap pair. ## OpenAPI ````yaml GET /v4/swap/{PAIR}/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: /v4/swap/{PAIR}/quote: get: tags: - Swaps summary: Get Swap quote description: Returns the swap quote for a specific swap pair. operationId: getSwapQuote parameters: - name: PAIR in: path schema: type: string example: eth-usdt description: >- A valid swap pair `pairName` from the pairs list required: true - name: authorization in: header schema: type: string example: Bearer hello.world.token description: >- A valid customer authentication token in the format 'Bearer [auth token]'. required: false - name: query in: query style: form explode: true required: true schema: type: object properties: baseCurrencyAmount: type: number example: 200 description: >- A positive number representing how much crypto the user wants to swap. required: - baseCurrencyAmount responses: '200': description: Successful response — Swap Quote content: application/json: schema: $ref: '#/components/schemas/SwapQuote' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] components: schemas: SwapQuote: type: object properties: id: type: string example: 9b9d4036-bb99-4cb8-a61e-87d0750722d2 description: Unique identifier for the object. expiresAt: type: string example: '2024-02-23T00:58:26.577Z' description: Time at which the quote expires. Returned as an ISO 8601 string. extraFeeAmount: type: string example: '0.0000005' description: >- A positive number string representing your extra fee for the transaction. It is added to baseCurrencyAmount, feeAmount and networkFeeAmount when the swap is executed. networkFeeAmount: type: string example: '0.00039' description: >- A positive number string representing the network fee for the transaction. It is added to baseCurrencyAmount, feeAmount and extraFeeAmount when the swap is executed. extraFeeAmountInUSD: type: string example: '0' description: >- A positive number string representing your extra fee for the transaction, in USD. It is added to baseCurrencyAmount, feeAmount and and networkFeeAmount when the swap is executed. networkFeeAmountInUSD: type: string example: '20.049237585' description: >- A positive number string representing the network fee for the transaction, in USD. It is added to baseCurrencyAmount, feeAmount and extraFeeAmount when the swap is executed. baseCurrency: $ref: '#/components/schemas/CryptoCurrency' description: Details about the cryptocurrency the customer wants to swap. quoteCurrency: $ref: '#/components/schemas/CryptoCurrency' description: Details about the cryptocurrency the customer will receive. pairName: type: string example: eth-btc description: The name of the cryptocurrency pair. baseCurrencyAmount: type: string example: '1.123' description: >- A positive string number representing how much crypto the user wants to swap. quoteCurrencyAmount: type: string example: '0.0564' description: >- A positive string number representing the amount of cryptocurrency the customer will receive. Set when the purchase of cryptocurrency has been executed. feeCurrency: $ref: '#/components/schemas/CryptoCurrency' description: Fee currency for this quote baseCurrencyPriceInUsd: type: string example: '2946.441235' description: The price of the crypto the customer wants to swap, in USD. quoteCurrencyPriceInUsd: type: string example: '51408.3015' description: The price of the crypto the customer will receive, in USD. liveMode: type: boolean example: true description: Whether live mode is enabled for this quote. exchangeRate: type: string example: '0.05731450269758475' description: The rate provided by the underlying exchange. signature: type: string example: really-long-string description: The signature for executing the quote Error: type: object properties: message: type: string description: A descriptive error message. type: type: string description: An error type. 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 ````