Get a quote

Prices a collection 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

Only KES is supported.

number

The USDC amount you want to receive. The customer is charged this amount converted to KES, plus the platform fee. Provide this or amount_kes, not both.

number

The exact KES amount to charge the customer. The fee is taken from it and the remainder converts to USDC. Provide 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)

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

number

required

The exact figure the customer’s phone will be prompted to pay.

number

required

Minisend fee in KES, included in amount_kes.

number

required

amount_kes minus fee_kes. What converts to USDC.

number

required

What your address will receive.

number

required

KES per 1 USDC.

string

required

Indicative 5-minute quote validity, ISO 8601. The order executes at the live rate at creation time regardless.

Errors

Status	Meaning
`400`	Neither or both of `amount_usdc`/`amount_kes` provided; the charged KES amount is outside 20 to 250,000; or the net amount after the fee is below the 100 KES floor
`403`	Key lacks the `onramp` scope or onramp is not enabled on your account
`502`	Rate temporarily unavailable. Retry

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