Skip to main content
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:
ZAR,
NGN,
KES,
GHS,
UGX,
TZS,
ZMW,
ETB
​
destinationCurrency
enum<string>
required

Destination currency code

Available options:
USDC,
USDT

Response

Currency conversion successful

​
convertedAmount
number
required

Total converted amount in the destination currency, inclusive of payout fee, payment network fee, and any applicable Optional Issuer Fee (OIF).

​
exchangeRate
string
required

Market exchange rate sourced from local liquidity partners.

​
expiryTimestamp
integer<int64>

Timestamp (Unix timestamp) when the conversion amount expires

​
payoutFee
string

The payout fee comprises the mobile money or bank payout fee, payment network fee, and any applicable Optional Issuer Fee (OIF), and is included in the converted amount.