Skip to main content
GET
/
v1
/
rates
/
{token}
/
{amount}
/
{fiat}
GET /v1/rates/USDC/100/KES HTTP/1.1
Host: api.rails.dev

{
  "status": "success",
  "message": "Rate fetched successfully",
  "data": {
    "rate": "1374.6",
    "fiat_amount": "13746.00",
    "fee": "0.50",
    "eta": 120
  }
}
Retrieve the live conversion rate, fees, and ETAs for converting stablecoins to local fiat currency. This endpoint is public and requires no authentication. The returned rate is the executable corridor rate after Rails applies the flat 0.5% B2B provider fee on top of the upstream settlement quote.

​
Path Parameters

​
token
string
required
The stablecoin type (USDC or USDT).
​
amount
string
required
The amount of stablecoin to convert (e.g. "100").
​
fiat
string
required
The target fiat currency code (NGN, KES, UGX, TZS, MWK, BRL).
Supported corridors are live-quoted from the settlement provider. If the upstream source cannot price a corridor, Rails returns an error instead of fabricating a rate.

​
Response

Returns the standard response envelope wrapping rate quote details.
​
status
string
Response state (success).
​
data
object
Rate payload.
​
rate
string
The executable exchange rate after the 0.5% provider fee.
​
fiat_amount
string
Calculated local currency output.
​
fee
string
Estimated transaction fee, in coin units.
​
eta
integer
Estimated settlement duration in seconds.

​
Example Payloads

GET /v1/rates/USDC/100/KES HTTP/1.1
Host: api.rails.dev

{
  "status": "success",
  "message": "Rate fetched successfully",
  "data": {
    "rate": "1374.6",
    "fiat_amount": "13746.00",
    "fee": "0.50",
    "eta": 120
  }
}