Get a quote

Tells you what a payout will cost and what the recipient will get, without creating anything. Add the recipient and we’ll also check their account and give you the name it’s registered to.

Endpoint

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

Authorization: Bearer ms_live_your_key_here

Requires the offramp scope. See getting access.

Body

number

required

The amount in USDC, from 0.5 to 50,000. The local amount also has to be within the limits for the currency.

string

required

Payout currency: KES, NGN, GHS, or UGX.

object

Optional. If you add it, we check the account and return the registered name as recipient_name. See recipients for the fields. An invalid account returns 422.For KES, add it when you can. The recipient decides which way the order goes, and that changes the price. Without it, a KES quote is priced as a payout to an M-Pesa phone.

Example

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

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

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/offramp/quote",
    headers={
        "Authorization": "Bearer ms_live_your_key_here",
        "Content-Type": "application/json",
    },
    json={"amount": 10, "currency": "KES"},
)

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

Response (200)

{
  "amount_usdc": 10,
  "currency": "KES",
  "rate": 129.45,
  "amount_local": 1294,
  "fee": 13,
  "recipient_amount": 1281,
  "expires_at": "2026-07-05T12:05:00.000Z"
}

number

required

Local currency per 1 USDC.

number

required

The local amount before the fee: amount × rate, rounded down to a whole number.

number

required

Our fee in local currency, taken from the payout on send-and-confirm orders. 0 on automatic orders, where a sender fee is added to what you send instead.

number

required

What the recipient actually gets: amount_local − fee.

boolean

required

Which way an order with these details would go. false means automatic.

number

Automatic orders only. Roughly what you’ll send, including the sender fee. A small network fee can be added when you create the order, so send the exact total_deposit_usdc the order gives you, not this.

string

The name the account is registered to, when you added a recipient and we found a name.

string

required

Roughly how long this quote holds, about 5 minutes, ISO 8601. On send-and-confirm orders, we pay out at the live rate when your USDC arrives anyway. On automatic orders, the rate is fixed when you create the order.

Errors

Status	Meaning
`400`	Something in the request isn’t right: the amount, the currency, or the recipient fields. Or the local amount is outside the allowed range
`403`	Off-ramp isn’t switched on for your account yet
`422`	You added a recipient and their account didn’t pass our check
`502`	We couldn’t get a rate or check the recipient 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)

Errors

​Endpoint

​Body

​Example

​Response (200)

​Errors

Endpoint

Body

Example

Response (200)

Errors