Imhotep Exchange Rates API

Overview

The Currency Exchange API allows users to retrieve real-time foreign exchange rates for various currencies. This API is perfect for developers who want to integrate currency conversion features into their applications, whether for e-commerce, finance, or travel services. Best of all, it is completely free to use!

Features

• Completely Free: No hidden costs or subscription fees, making it accessible for all users.
• Real-time Exchange Rates: Fetch the latest currency rates with a simple API call.
• Customizable Base Currency: Specify the base currency for conversion, allowing flexibility in financial calculations.
• Secure API Access: Each user is provided with a unique API key to ensure secure and personalized access.

Getting Started

1. Sign Up and Get Your API Key

• Register on the homepage to receive your free API key.
• Each user is granted one API key which must be included in the URL for each API request.

2. API Endpoints

Fetch Latest Exchange Rates

• Endpoint: /latest_rates/<base_currency>

• Method: GET

• Parameters:

  • base_currency (required): The base currency for which exchange rates should be calculated, e.g., USD, EUR.
  • api_key (required): Your unique API key, which you received upon registration.

• Example Request:

  
  GET https://<your-domain>/latest_rates/USD?api_key=YOUR_API_KEY
  
  

• Response: Returns a JSON object containing:

  • meta: Information about the request, including the base currency and last update timestamp.
  • data: An object containing currency codes as keys and their conversion rates relative to the base currency.

Sample Response:

{
  "meta": {
    "base_currency": "USD",
    "last_updated_at": "2024-10-25T15:00:00"
  },
  "data": {
    "EUR": 0.85,
    "JPY": 110.45,
    "GBP": 0.75,
    ...
  }
}

Usage Example

1.Get Exchange Rates for EUR:

GET https://<your-domain>/latest_rates/EUR?api_key=YOUR_API_KEY

2. Change Base Currency to EGP:

GET https://<your-domain>/latest_rates/GBP?api_key=YOUR_API_KEY

Error Handling

If there are issues with your request, such as an invalid API key or unsupported base currency, you will receive an error response:

{
  "error": "Error message here"
}

Rate Limiting

Each API key allows for unlimited requests per month.