Latest rate

Retrieves the latest exchange rates for a specified base currency against multiple target currencies. This endpoint provides real-time conversion rates, making it useful for financial applications, currency converters, and data analysis tools.

Request Method: GET

Response Format:

Returns a JSON object containing the status of the request, a message, and the exchange rate data, including the base currency, exchange rates, and the last updated timestamp.

Response Example:

{
  "status": "success",
  "message": "retrieved",
  "data": {
    "timestamp": 1738607282542,
    "base": "USD",
    "market": "parallel",
    "rates": {
      "NGN": 1619.01
    }
  }
}

Response Parameters:

status (string) – Indicates the success or failure of the request (e.g., "success").

message (string) – Provides a brief message about the request status (e.g., "retrieved").

data (object) – Contains the core exchange rate information:

base (string) – The base currency code used for conversions (e.g., "NGN").

rates (object) – Key-value pairs of target currency codes and their corresponding exchange rates (e.g., "USD": 0.00060369).

timestamp (string, ISO 8601) – Timestamp indicating the last time the rates were updated.

Usage:

Ideal for applications that require up-to-date exchange rates, such as financial dashboards, e-commerce platforms, and currency converters. It provides a snapshot of how various currencies compare to the specified base currency.

application/json

Bodyapplication/json

Example

{
    "status": "success",
    "message": "retrieved",
    "data": {
        "timestamp": 1738607282542,
        "base": "USD",
        "market": "mid",
        "rates": {
            "NGN": 1619.01
        }
    }
}

Request

Request Code Samples

Responses