Skip to main content
🚧 The Ramp API is currently under construction. Endpoints and features described here are subject to change. Do not use in production until this notice is removed.
The meCash Ramp API lets you move value across the crypto–fiat boundary programmatically. There are two transaction categories:
  • Crypto-to-Crypto — transfer a supported token (USDC, USDT, ETH) from your meCash wallet to any external blockchain address.
  • Offramp (Crypto-to-Fiat) — convert crypto to a fiat currency (NGN, USD, EUR, GBP, CAD) and deliver it via bank transfer or mobile money.
Both flows share the same API shape: create a quote → execute a transaction → receive a webhook.

​
Ramp API lifecycle

​
Crypto-to-Crypto

​
Offramp (Crypto-to-Fiat)

Subscribe to ramp webhooks to receive reliable transaction outcome notifications. See the Ramp Webhook Events for payload details.

​
Operational considerations

  • Quotes expire: Ramp quotes are valid for a limited window (~5–10 minutes). Always create a new quote if the previous one has expired before you call /order.
  • Gas fees are mandatory: Crypto-to-crypto transfers require gas. Use the Get Gas Fee endpoint to present accurate fee options (LOW / MEDIUM / HIGH) to your users before quoting.
  • Offramp gas is included in the quote: When you call Create Quote (Offramp), the gasFee object is returned alongside the quote — no separate gas lookup is needed.
  • Check rules before executing: The rules array on every quote response enforces per-corridor minimum and maximum limits. Validate these in your UI before allowing users to proceed.
  • Webhooks are the source of truth: The /order response gives you an initial PENDING state. Treat it as an acknowledgement only. Final COMPLETED or FAILED status arrives asynchronously via webhook.
  • Fetch wallet balance first: Use Get Wallet Balance to confirm sufficient funds before creating a quote, especially for crypto-to-crypto transfers where gas is additive.

​
Transaction states

​
Ramp API routes

Get Wallet Balance

Check available and pending token balances before initiating a transfer.

Get Gas Fee

Estimate LOW / MEDIUM / HIGH gas fees for a crypto-to-crypto transfer.

Create Quote (Crypto)

Generate a quote for a crypto-to-crypto transfer with rate and fee breakdown.

Create Quote (Offramp)

Generate a quote to convert crypto to fiat currency.

Get Quote (Crypto)

Retrieve details of a previously created crypto-to-crypto quote by ID.

Get Quote (Offramp)

Retrieve details of a previously created offramp quote by ID.

Create Transaction

Execute a crypto or offramp transaction using a valid quoteId.

Get Transaction

Fetch the full details and current state of a Ramp transaction.

​
Next steps