Atlas DocumentationExchange rate
Get Exchange Rates
Fetch the latest exchange-rate records for a requested currency pair, with optional pagination over the returned rate history.
Authorization
BearerAuth AuthorizationBearer <token>
In: header
Query Parameters
from_currency*string
3-letter source currency code
Length
3 <= length <= 3to_currency*string
3-letter destination currency code
Length
3 <= length <= 3page?integer
Pagination page number
Range
1 <= valuelimit?integer
Number of records per page
Range
1 <= value <= 100Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/exchange-rate/fetch?from_currency=NGN&to_currency=KES"{
"requestId": "3a6538fd-03f0-4b05-ba41-5d44769dd014",
"requestTimestamp": "2026-02-20 10:15:30.123",
"message": "Exchange rate retrieved successfully.",
"statusCode": 200,
"data": {
"id": "b3a2e3ac-2744-4fb8-8f5f-49555f1637e1",
"fromCurrency": "NGN",
"toCurrency": "USD",
"currentRate": 2050,
"buyRate": 2040,
"sellRate": 2050,
"rateType": "partner",
"partnerId": "8c5b077c-9b72-4dbf-b7d4-530d8e9b3985",
"rateKind": "sell",
"status": "active",
"createdAt": "2026-02-20 10:15:30.123",
"updatedAt": "2026-02-20 10:15:30.123"
}
}{
"requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
"requestTimestamp": "2026-02-20 10:15:30.123",
"message": "Unauthenticated.",
"statusCode": 401
}{
"requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
"requestTimestamp": "2026-02-20 10:15:30.123",
"message": "The given data was invalid.",
"errors": {
"from_currency": [
"The from currency field is required."
]
},
"statusCode": 422
}{
"requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
"requestTimestamp": "2026-02-20 10:15:30.123",
"message": "An error occurred while processing your request.",
"statusCode": 500
}How is this guide?