Quote

Returns an onramp Quote

This endpoint returns an accurate price estimate for the requested amount for the coin/token (fiat to crypto)

Create an Onramp Quote

POST https://integration.coinmena.com/onramp-bank/api/v1/onramp/quote

Request Body

Name	Type	Description
fromCurrency*	String	Base currency of the trading pair E.g. of fromCurrency: AED
toCurrency*	String	Quote currency of the trading pair E.g. of toCurrency: usdc | usdt | eth
fromAmount*	String	Fiat amount for onramp

200: OK Success

{
    "status": 1,
    "code": 200,
    "data": {
        "fromCurrency": "AED",
        "toCurrency": "USDT",
        "toAmount": 13.08,
        "fromAmount": "60",
        "fees": [
            {
                "type": "fiat",
                "onrampFee": 3,
                "clientFee": 0,
                "gatewayFee": 0,
                "gasFee": 0
            }
        ]
    }
}

500: Internal Server Error Internal Server Error

{
    "status": 0,
    "code": 500,
    "error": "Unable to generate Onramp quote at the moment. Please try again after some time."
}

400: Bad Request Missing required parameter(s)

{
    "status": 0,
    "code": 400,
    "error": "Missing Required parameters -> fromCurrency, toCurrency, fromAmount."
}

Response

{
    "status": 1,
    "code": 200,
    "data": {
        "fromCurrency": "AED",
        "toCurrency": "USDC",
        "toAmount": "1938.65",
        "fromAmount": "7213",
        "rate": "3.72",
        "fees": [
            {
                "type": "fiat",
                "onrampFee": "18.95",
                "clientFee": 0,
                "gatewayFee": 0,
                "gasFee": "3.72"
            }
        ]
    }
}

Explanation

• status -> 0 is for unsuccessful request, 1 is for a successful one

• fromCurrency -> fiat used for the transaction .

• toCurrency -> symbol of the coin e.g. USDT).

• fromAmount -> Amount of fiat received by the coinmena.

• toAmount -> actual amount of crypto bought at the time of swap/trade.

• rate -> expected price estimate shown at the beginning of the transaction

• fees (array of objects): Breakdown of different fees associated with the transaction.

  • type -> The type of fee (e.g., "fiat", "crypto").

  • onrampFee -> Onramp fee amount.

  • clientFee -> Client fee amount.

  • gatewayFee -> Gateway fee amount.

  • gasFee -> Gas fee amount.