Get a quote

Prices a payout without creating anything. Optionally validates the recipient and returns the registered account name in the same call.

Endpoint

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

Authorization: Bearer ms_live_your_key_here

Requires the offramp scope. See getting access.

Body

amount

number

required

USDC amount, 0.5 – 50,000. The local equivalent must also fall inside the per-transaction range for the currency.

currency

string

required

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

recipient

object

Optional. When present, the account is validated and the registered name is returned as recipient_name. Shape per method in recipients. An invalid account returns 422.

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"
}

rate

number

required

Local currency per 1 USDC.

amount_local

number

required

Gross local amount (amount × rate, floored to whole units).

fee

number

required

Minisend fee in local units: 1% for KES, GHS, UGX; 0 for NGN.

recipient_amount

number

required

What the recipient nets: amount_local − fee.

recipient_name

string

The registered account name, when a recipient was supplied and a name was resolved.

expires_at

string

required

Indicative 5-minute quote validity, ISO 8601. For KES, GHS, and UGX the payout executes at the live rate at deposit time regardless; for NGN the rate is locked when you create the order.

Errors

Status	Meaning
`400`	Invalid amount, unsupported currency, malformed recipient, or local amount outside the per-transaction range
`403`	Key lacks the `offramp` scope or off-ramp is not enabled on your account
`422`	Recipient supplied but failed validation
`502`	Rate temporarily unavailable. Retry

See error handling for the response shape.

​Endpoint

​Body

​Example

​Response (200)

​Errors

Endpoint

Body

Example

Response (200)

Errors