Rate Quotes & Spread
All deposit and withdrawal quotes include a spread applied on top of the live market FX rate. The total spread is the sum of Regini's base margin and any additional margin you have configured on your program.
The spread is always applied against the user:
Deposits (fiat to USDC): the effective rate is marked up, so the user receives fewer USDC per unit of fiat paid.
effective_rate = market_rate × (1 + spread_bps / 10000)
usdc_received = fiat_amount / effective_rate
Withdrawals (USDC to fiat): the effective rate is marked down, so the user receives less fiat per USDC sold.
effective_rate = market_rate × (1 - spread_bps / 10000)
fiat_received = usdc_amount × effective_rate
Fiat amounts are in your market's currency (KES in Kenya). The exchange_rate in every quote response is the effective fiat-per-USDC rate with the full spread already applied, this is the rate to show the user.
Quote lifecycle
| Property | Value |
|---|---|
| Validity | 10 minutes from issue |
| Reuse | Single-use; consumed on a successful deposit or withdrawal |
| Expiry | RATE_EXPIRED error if used after 10 minutes or after first use |
Configuring your partner spread
You can add your own FX margin on top of Regini's base spread at the program level. This is optional, if you do not configure one, the Regini base spread is the only margin applied.
PATCH /programs/{program_id}/spread
Requires scope: accounts:create
| Field | Type | Constraints |
|---|---|---|
partner_spread_bps |
integer | 0 – 500 (0 removes the partner spread) |
Revenue from your additional spread is credited to your FX spread ledger account and visible in your Ledger view.
Response:
The change takes effect on the next quote issued. Existing locked quotes (rate_ids already issued) continue to use the spread at the time they were created.