Atlas DocumentationFx swap
Get FX Rates History
Retrieve historical FX rates for a currency pair within an optional date range.
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 <= 3start_date?string
Start date for the history window
Format
dateend_date?string
End date for the history window
Format
datepage?integer
Pagination page number
Range
1 <= valuelimit?integer
Number of records per page
Range
1 <= value <= 200Response Body
application/json
curl -X GET "https://example.com/api/v1/fx/rates/history?from_currency=NGN&to_currency=USD"{
"requestId": "737a4b93-d6fc-43e3-936f-217b58f4a4b9",
"requestTimestamp": "2026-04-21 14:28:11",
"message": "FX rates history fetched successfully.",
"statusCode": 200,
"data": [
{
"fromCurrency": "NGN",
"toCurrency": "USD",
"rate": 1587.42,
"recordedAt": "2026-03-12T10:30:00+00:00"
}
],
"links": {},
"meta": {}
}Empty
Empty
Empty
How is this guide?