Skip to main content
GET
/
v1
/
ramp
/
quote
/
{quoteId}
Get Quote
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://sandboxapi.me-cash.com/v1/ramp/quote/{quoteId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "status": "success",
  "message": "quote generated successfully",
  "data": {
    "id": "3f41daaa-029c-44a2-b7c6-ed922a68177b",
    "source": {
      "currency": "USDC",
      "symbol": "USDC",
      "type": "CRYPTOCURRENCY",
      "amount": 5,
      "network": {
        "id": "f8fc48ff-81e6-4b5f-9a70-44fb744e3572",
        "name": "USDC",
        "blockchain": "MATIC-AMOY"
      }
    },
    "target": {
      "currency": "NGN",
      "country": "NG",
      "type": "FIAT",
      "paymentChannel": "BANK_TRANSFER",
      "amount": 5537.1
    },
    "rate": 1107.42,
    "fees": [
      {
        "amount": 0.025,
        "gas": {
          "type": "MEDIUM",
          "total": 0.29237925
        }
      }
    ],
    "summary": {
      "total": 5.31737925
    },
    "expiresInSeconds": 600
  }
}

​
Get Quote (Off Ramp)

This endpoint fetches the complete details of a specific off-ramp (crypto-to-fiat) quote, using its quote_id. The data includes source crypto, target fiat, rates, fees, and transaction rules.

​
Endpoint

GET {{baseURL}}/v1/ramp/quote/{{quote_id}}

​
Headers

HeaderValueRequired
Content-Typeapplication/jsonYes
x-api-keyYOUR_API_KEYYes

​
Path Parameter

ParameterTypeDescription
quote_idstringUnique identifier of the quote

​
Example Request

This example shows how to retrieve the details of a specific ramp quote using its unique ID. 
# Replace YOUR_QUOTE_ID with the actual ID of the quote
curl --location --request GET '{{appUrl}}/v1/ramp/quote/YOUR_QUOTE_ID' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json'

​
Successful Response 200 OK

{
  "message": "quote successfully fetched",
  "status": "success",
  "data": {
    "id": "92da6ea0-79fe-4000-971d-c481ed495a6a",
    "source": {
      "currency": "Polygon",
      "symbol": "POL",
      "addressRegex": "^(0x)[0-9A-Fa-f]{40}$",
      "amount": 0.12,
      "blockchain": "MATIC",
      "type": "CRYPTOCURRENCY"
    },
    "target": {
      "currency": "NGN",
      "country": "NG",
      "amount": 117.30,
      "type": "FIAT"
    },
    "rate": 0.00102300,
    "fees": {
      "symbol": "POL",
      "amount": 0.00,
      "gas": {
        "type": "MEDIUM",
        "amount": 0.01909123
      }
    },
    "rules": [
      {
        "category": "LIMIT",
        "appliedCurrency": "NGN",
        "appliedCountry": "NG",
        "transaction": {
          "minimum": 10.00,
          "maximum": 2000000.00
        },
        "invoice": 2000000.00
      }
    ],
    "summary": {
      "total": 0.12
    }
  }
}

​
Error Codes

CodeMessage
400Bad request – invalid or missing fields
401Unauthorized – invalid API key
500Internal server error

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
quoteId
string<uuid>
required

The unique identifier of the quote.

Response

Quote retrieved successfully.

​
status
string
Example:

"success"

​
message
string
Example:

"quote generated successfully"

​
data
object