Skip to main content
GET
Get a live FX rate (informational)

Authorizations

Authorization
string
header
required

Stablepay API key. Include as Authorization: Bearer <key>.

Query Parameters

amount
number
required

Amount to convert

Example:

1000

sourceCurrency
enum<string>
required

The currency to convert from (fiat or stablecoin).

Available options:
CDF,
GHS,
KES,
NGN,
TZS,
UGX,
XAF,
XOF,
ZAR,
ZMW,
USDC,
USDT
destinationCurrency
enum<string>
required

The currency to convert to.

Available options:
USDC,
USDT,
CDF,
GHS,
KES,
NGN,
TZS,
UGX,
XAF,
XOF,
ZAR,
ZMW
paymentMethod
enum<string>
required
Available options:
MOMO,
BANK,
PAYBILL,
TILL
direction
enum<string>
required

payout: issuer sends stablecoin → recipient receives fiat. payin: customer pays fiat → issuer receives stablecoin.

Available options:
payout,
payin
optionalIssuerFee
enum<string>
required
Available options:
YES,
NO
country
enum<string>

For XOF payments, the recipient country must be specified.

Available options:
BJ,
BF,
CD,
CI,
SN

Response

Indicative FX rate and fee breakdown for the requested corridor.

convertedAmount
string
required

Total converted amount in the destination currency (inclusive of network fee, optional issuer fee and payment fee).

Example:

"10.680"

exchangeRate
string
required

Market exchange rate sourced from local liquidity partners (inclusive of network fee and optional issuer fee)

Example:

"128.218000"

paymentFee
string
required

The fee comprises the mobile network operator or bank processing fee.

Example:

"20"

expiryTimestamp
integer<int64>
required

Unix timestamp (seconds) after which this rate expires.

Example:

1750334460