Create a 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:false

Example:

false

beneficiary

NGN Beneficiary · object

NGN Beneficiary
KES Beneficiary
GHS Beneficiary
ZAR Beneficiary
BTC Beneficiary

Show child attributes

Response

Quote response

status

string<string>

Example:

"ok"

data

object

Show child attributes

API Documentation

API Endpoints

Authorizations

Body

Response