Skip to main content
POST
/
quote
curl --request POST \
  --url https://staging.api.mavapay.co/api/v1/quote \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "amount": "500000",
  "sourceCurrency": "NGNKOBO",
  "targetCurrency": "BTCSAT",
  "paymentMethod": "BANKTRANSFER",
  "paymentCurrency": "NGNKOBO",
  "customerReference": "order-1234567890",
  "autopayout": false
}
'
{
  "status": "ok",
  "data": {
    "id": "53a87b44-2ecc-4106-8297-f1fd15d010a9",
    "exchangeRate": 1,
    "usdToTargetCurrencyRate": 0.00000917325600278523,
    "sourceCurrency": "NGNKOBO",
    "targetCurrency": "BTCSAT",
    "transactionFeesInSourceCurrency": 4624,
    "transactionFeesInTargetCurrency": 25,
    "amountInSourceCurrency": 844540,
    "amountInTargetCurrency": 5000,
    "paymentMethod": "BANKTRANSFER",
    "expiry": "2025-09-01T12:52:08.215Z",
    "isValid": true,
    "invoice": "",
    "hash": "68b594a09a16ac0012ae3414",
    "totalAmountInSourceCurrency": 844540,
    "customerInternalFee": 0,
    "bankName": "GLOBUS BANK",
    "ngnBankAccountNumber": "3242273802",
    "ngnAccountName": "Mava Digital Solutions Limited",
    "ngnBankCode": "000027",
    "estimatedRoutingFee": 0,
    "orderId": "43477-4306"
  }
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
amount
number<number>
required

The amount in the target currency in its lowest denomination. e.g '500000' for 5000.00 NGN

Example:

1000

​
sourceCurrency
enum<string>
default:BTCSAT
required

The source currency for the quote

Available options:
BTCSAT,
NGNKOBO
​
targetCurrency
enum<string>
default:NGNKOBO
required

The local currency to convert the source currency to

Available options:
NGNKOBO,
KESCENT,
ZARCENT,
GHSPESEWA,
BTCSAT
​
paymentMethod
enum<string>
default:LIGHTNING
required

The payment method for the quote

Available options:
LIGHTNING,
BANKTRANSFER
​
paymentCurrency
enum<string>
required

Currency the amount is denominated in. Must be either sourceCurrency or targetCurrency. Determines what the 'amount' field represents. Example: if buying BTC with NGN and paymentCurrency is 'NGNKOBO', amount is in Naira; if 'BTCSAT', amount is in Bitcoin.

Available options:
NGNKOBO,
BTCSAT,
KESCENT,
ZARCENT,
GHSPESEWA
​
customerReference
string<string>

Your unique identifier for the quote

Example:

"order-1234567890"

​
autopayout
boolean<boolean>
default:true
Example:

true

​
beneficiary
NGN Beneficiary · object

Response

Quote response

​
status
string<string>
Example:

"ok"

​
data
object