> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learnway.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Exchange Rates

> Real-time fiat-to-USDT conversion rates for Fonbnk-supported currencies.

# Exchange Rates

The Exchange Rate service aggregates real-time currency pricing from CoinMarketCap and partner oracles, caching conversion rates in Redis with automated 2-hour refresh intervals.

***

## Get USDT Exchange Rates

Retrieves the current USDT conversion rates across all supported fiat currencies.

### Endpoint

```http theme={null}
GET /api/v2/exchange-rates
```

### Response (200 OK)

```json theme={null}
{
  "success": true,
  "message": "Exchange rates retrieved successfully",
  "data": {
    "baseCurrency": "USDT",
    "rates": {
      "NGN": { "rate": 1450.50, "updatedAt": "2026-08-21T22:00:00.000Z" },
      "KES": { "rate": 129.20, "updatedAt": "2026-08-21T22:00:00.000Z" },
      "GHS": { "rate": 15.40, "updatedAt": "2026-08-21T22:00:00.000Z" },
      "UGX": { "rate": 3720.00, "updatedAt": "2026-08-21T22:00:00.000Z" },
      "ZAR": { "rate": 18.15, "updatedAt": "2026-08-21T22:00:00.000Z" },
      "BRL": { "rate": 5.45, "updatedAt": "2026-08-21T22:00:00.000Z" }
    },
    "cachedAt": "2026-08-21T22:00:00.000Z"
  }
}
```
