How to Get Exchange Rates in Python: A Step-by-Step Guide

Introduction

Fetching exchange rates in Python can be easily accomplished with a REST API like CurrencyRest. In this guide, we'll walk through the steps to retrieve real-time and historical exchange rates using Python, handling potential errors, and implementing caching mechanisms to improve performance. Let's get started!

Step 1: Setting Up Your Environment

To begin, make sure you have Python installed (preferably version 3.6 or higher). You'll also need the requests library, which simplifies HTTP requests. Install it via pip:

pip install requests

Step 2: Getting Your API Key

Sign up on CurrencyRest to obtain your API key. You can start with a free plan that allows for 300 requests per month.

Step 3: Making Your First API Call

With your environment ready and your API key in hand, it’s time to make a call to the CurrencyRest API. Here’s a simple example to convert 100 USD to XOF:

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://api.currencyrest.com/api/v1/'

def get_exchange_rate(from_currency, to_currency, amount):
    try:
        url = f'{BASE_URL}convert?from={from_currency}&to={to_currency}&amount={amount}&apikey={API_KEY}'
        response = requests.get(url)
        response.raise_for_status()  # Raise an error for bad responses
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f'Error fetching data: {e}')
        return None

result = get_exchange_rate('USD', 'XOF', 100)
if result:
    print(result)

This code fetches the exchange rate from USD to XOF for 100 units and prints the result.

Step 4: Caching the Results

To avoid unnecessary API calls and speed up your application, consider implementing caching. Here’s an example using a simple dictionary:

cache = {}

def get_cached_exchange_rate(from_currency, to_currency, amount):
    cache_key = f'{from_currency}_{to_currency}_{amount}'
    if cache_key in cache:
        return cache[cache_key]
    result = get_exchange_rate(from_currency, to_currency, amount)
    if result:
        cache[cache_key] = result
    return result

cached_result = get_cached_exchange_rate('USD', 'XOF', 100)
if cached_result:
    print(cached_result)

This code checks if the result is in the cache before making a request, improving performance.

Step 5: Handling Errors Gracefully

Proper error handling is essential. We already have error handling in our get_exchange_rate function. However, you can extend it by handling different HTTP status codes to provide better feedback.

Conclusion

In this guide, we’ve walked through how to fetch exchange rates in Python using the CurrencyRest API. With error handling and caching, you can make efficient and robust applications. Don’t forget to check the CurrencyRest API documentation for more options and features.

Now that you're equipped with the knowledge to get started, sign up for CurrencyRest and enjoy 300 free API requests each month!