GET
/
fx
/
convert
Convert Currency
curl --request GET \
  --url https://api.stablepay.ai/fx/convert \
  --header 'Authorization: Bearer <token>'
{
  "convertedAmount": 123,
  "exchangeRate": "<string>",
  "expiryTimestamp": 123,
  "payoutFee": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer scheme. Format: Bearer {STA_xxxx}

Query Parameters

​
amount
number
required

Amount to convert

Required range: x >= 0.01
​
sourceCurrency
enum<string>
required

Source currency code

Available options:
KES,
UGX,
GHS
​
destinationCurrency
enum<string>
required

Destination currency code

Available options:
USDC

Response

Currency conversion successful

​
convertedAmount
number
required

Total converted amount in destination currency, including payout fee (if applicable).

​
exchangeRate
string
required

Exchange rate, including transaction processing fees.

​
expiryTimestamp
integer

Timestamp (Unix timestamp) when the conversion amount expires

​
payoutFee
string

Additional MoMo transaction fee applicable for low value transactions, included in converted amount.