Get a quote

Tells you what a collection will cost and what you’ll receive, without creating anything or sending a payment prompt.

Endpoint

POST https://merchant.minisend.xyz/api/onramp/quote

Authorization: Bearer ms_live_your_key_here

Requires the onramp scope. See getting access.

Body

string

required

KES (M-Pesa) or NGN (bank transfer).

number

How much USDC you want to receive. Your customer pays that amount in local currency, plus the platform fee. Send this or amount_kes / amount_ngn, not both.

number

KES only. Exactly how much KES to charge your customer. We take the fee from it and turn the rest into USDC. Send this or amount_usdc, not both.

number

NGN only, up to 2 decimal places. Exactly how much NGN to charge the payer. We take the fee from it and turn the rest into USDC. Send this or amount_usdc, not both.

Example

curl -X POST https://merchant.minisend.xyz/api/onramp/quote \
  -H "Authorization: Bearer ms_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"currency": "KES", "amount_kes": 1000}'

const res = await fetch('https://merchant.minisend.xyz/api/onramp/quote', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ms_live_your_key_here',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ currency: 'KES', amount_kes: 1000 }),
});

if (!res.ok) throw new Error((await res.json()).error);
const quote = await res.json();

import requests

res = requests.post(
    "https://merchant.minisend.xyz/api/onramp/quote",
    headers={
        "Authorization": "Bearer ms_live_your_key_here",
        "Content-Type": "application/json",
    },
    json={"currency": "KES", "amount_kes": 1000},
)

res.raise_for_status()
quote = res.json()

Response (200), KES

{
  "currency": "KES",
  "payment_method": "mpesa",
  "amount_kes": 1000,
  "fee_kes": 10,
  "net_kes": 990,
  "amount_usdc": 7.62,
  "rate": 129.92,
  "expires_at": "2026-07-23T12:05:00.000Z"
}

Response (200), NGN

{
  "currency": "NGN",
  "payment_method": "bank_transfer",
  "amount_ngn": 10120,
  "fee_ngn": 120,
  "net_ngn": 10000,
  "amount_usdc": 7.14,
  "rate": 1400,
  "expires_at": "2026-09-26T10:05:00.000Z"
}

string

required

mpesa or bank_transfer.

number

KES only. Exactly what your customer will be asked to pay on their phone.

number

KES only. Our fee in KES. It’s already part of amount_kes.

number

KES only. amount_kes minus fee_kes. This is the part that becomes USDC.

number

NGN only. Exactly what the payer will be asked to send.

number

NGN only. Our fee in NGN. It’s already part of amount_ngn.

number

NGN only. amount_ngn minus fee_ngn. This is the part that becomes USDC.

number

required

What your address will receive.

number

required

How much local currency 1 USDC is worth right now.

string

required

Roughly how long this quote holds, ISO 8601. A quote doesn’t fix the price. The order uses the live rate at the moment you create it.

Errors

Status	Meaning
`400`	Send exactly one amount (`amount_usdc`, `amount_kes`, or `amount_ngn`), within the limits, with a `currency` of `KES` or `NGN`
`403`	The onramp isn’t switched on for your account yet
`502`	We couldn’t get a rate just now. Try again

See error handling for the response shape.

Overview

Endpoints

Off-ramp endpoints

Onramp endpoints

Wallet API endpoints

Get a quote

Endpoint

Body

Example

Response (200), KES

Response (200), NGN

Errors

​Endpoint

​Body

​Example

​Response (200), KES

​Response (200), NGN

​Errors

Endpoint

Body

Example

Response (200), KES

Response (200), NGN

Errors