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

Body

status

string

required

message

string

required

data

object

required

timestamp

number

required

the last timestamp the rate was updated

base

string

required

the base currency

market

string

required

the rate market

rates

object

required

Example

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

Request

Request samples

Responses