Price | Fonbnk Docs

Returns expected price in USDC, cUSD etc. for a given amount of mobile money and vice versa.

get

/api/pay-widget-merchant/price

Authorizations

Query parameters

networkstring · enumrequired

Options: POLYGON, ETHEREUM, STELLAR, AVALANCHE, SOLANA, ALGORAND, CELO, BASE, TON, LISK, ARBITRUM, OPTIMISM, BNB

assetstring · enumrequired

Options: USDC, USDC_E, USDT, CUSD, CKES

currencystring · enumrequired

Options: usdc, local

amountnumberrequired

countrystringrequired

country ISO code, e.g. NG

providerstring · enumrequired

Options: bank_transfer, mobile_money, mpesa, carrier

carrierIdstring

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://sandbox-api.fonbnk.com/api/pay-widget-merchant/price?network=POLYGON&asset=USDC&currency=usdc&amount=1&country=text&provider=bank_transfer' \
  --header 'x-client-id: YOUR_API_KEY'

200

{
  "quoteId": "651e764399a4b360c7eb0178",
  "cryptoTotalAmount": 5.12,
  "cryptoWithdrawAmount": 5,
  "cryptoFeeAmount": 0.12,
  "cryptoGasAmount": 0,
  "localCurrencyAmount": 5120,
  "feePercent": 2.5,
  "fonbnkFeePercent": 1.5,
  "partnerFeePercent": 1,
  "totalAmount": 5.12,
  "withdrawAmount": 5,
  "feeAmount": 0.12,
  "localCurrencyFeeAmount": 120,
  "fonbnkFeeAmount": 0.07,
  "localCurrencyFonbnkFeeAmount": 70,
  "partnerFeeAmount": 0.05,
  "localCurrencyPartnerFeeAmount": 50,
  "networkFeeAmount": 0,
  "localCurrencyNetworkFeeAmount": 0,
  "usdcTotalAmount": 5.12,
  "usdcWithdrawAmount": 5,
  "usdcFeeAmount": 0.12,
  "usdcGasAmount": 0
}

Successful response

Get price