Skip to main content
POST
/
v1
/
quotes
{
  "coin": "USDC",
  "amount": "100.00",
  "fiat_currency": "NGN",
  "route_preference": "route_a"
}

{
  "rate": "1530.50",
  "fiat_amount": "153050.00",
  "fee": "0.50",
  "eta": 120,
  "route_allocated": "route_a",
  "expires_at": "2026-06-13T12:00:30Z"
}
Request a non-binding real-time exchange rate quote. Use this endpoint to display accurate rates to users in your application UI before they initialize an order. Quotes are valid for 30 seconds.

​
Header Parameters

​
Authorization
string
required
Bearer API Key (e.g. rk_live_...).

​
Request Body

​
coin
string
required
The stablecoin type (USDC or USDT).
​
amount
string
required
The stablecoin amount to convert (e.g. "100.00").
​
fiat_currency
string
required
The target fiat currency code (NGN, KES, TZS, MWK).
​
route_preference
string
default:"route_a"
The routing pathway preference:
  • route_a: Use the configured B2B settlement route on Sui.

​
Response

​
rate
string
The exchange rate (fiat units per stablecoin unit).
​
fiat_amount
string
Estimated local currency output.
​
fee
string
Estimated transaction fee, in coin units.
​
eta
integer
Estimated settlement duration in seconds.
​
route_allocated
string
The route allocated for this quote based on rules and liquidity (route_a).
​
expires_at
string
ISO 8601 timestamp after which the quote rate is no longer guaranteed.
Requesting a quote with an unsupported corridor will return a 422 Unprocessable Entity with error code INVALID_ROUTING.

​
Example Payloads

{
  "coin": "USDC",
  "amount": "100.00",
  "fiat_currency": "NGN",
  "route_preference": "route_a"
}

{
  "rate": "1530.50",
  "fiat_amount": "153050.00",
  "fee": "0.50",
  "eta": 120,
  "route_allocated": "route_a",
  "expires_at": "2026-06-13T12:00:30Z"
}