v31

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-07-082421122.2 KB

Quote

Create a quote

Create a quote for a given currency

post/quote

Request body

amountnumber required

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

sourceCurrency'BTCSAT' | 'NGNKOBO' string required

The source currency for the quote

targetCurrency'NGNKOBO' | 'KESCENT' | 'ZARCENT' | 'GHSPESEWA' | 'BTCSAT' string required

The local currency to convert the source currency to

paymentMethod'LIGHTNING' | 'BANKTRANSFER' string required

The payment method for the quote

paymentCurrency'NGNKOBO' | 'BTCSAT' | 'KESCENT' | 'ZARCENT' | 'GHSPESEWA' 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.

customerReferencestring string

Your unique identifier for the quote

autopayoutboolean

Example request

{
  "amount": 1000,
  "customerReference": "order-1234567890",
  "beneficiary": {
    "bankAccountNumber": "0149203789",
    "bankAccountName": "olaolu olajide",
    "bankCode": "000013",
    "bankName": "GTBANK PLC"
  }
}

Response

Quote response

statusstring string

Example response

{
  "status": "ok",
  "data": {
    "id": "d1614a76-9c7f-4111-98a7-43199f307e5b",
    "exchangeRate": 103830225.71866913,
    "usdToTargetCurrencyRate": 1500.65,
    "transactionFeesInSourceCurrency": 13.23,
    "transactionFeesInTargetCurrency": "3750.00",
    "amountInSourceCurrency": 1499,
    "amountInTargetCurrency": "50000.00",
    "expiry": "2021-07-01T12:00:00Z",
    "isValid": true,
    "invoice": "lntbs36020n1pnehfzcpp5zc8g9tfpwnmaevh62ak2vu6zjqyt5cpph3gjm4zfyqz9srjjdsaqdz5296k7ar98gsy6ctkvys9qcteyqmnyenr8yunswfdvyer2v3dx33kxe3dvymnsefdv5mnjcm9x5mrydm9vccqcqzpuxqzfvsp5utd7hdfmjp7vw3lc6hal8psqruwcnu89hxfukyzugxh40jhv8xcq9qxpqysgq2lry5dgzu2g04s74tpvctwe37rkprs3k579jw6yt7ncrsg62p29yalw8gf5fawfvpydqv4jjve0nsysfhsxa35dtwug9e6gzxkq0h5gp636wc3",
    "hash": "189727ef2e0f35921af7858b96e27cbad960b0ec2bb2a4ab73b6a231f9ce8727",
    "customerReference": "order-1234567890",
    "totalAmountInSourceCurrency": 1499,
    "createdAt": "2021-07-01T12:00:00Z",
    "updatedAt": "2021-07-01T12:00:00Z",
    "bankName": "WEMA BANK",
    "ngnBankAccountNumber": "7824655568",
    "ngnAccountName": "Mava Digital Solutions Limited",
    "ngnBankCode": "000027",
    "orderId": "43477-4306"
  }
}