Live Exchange Rates.

This endpoint is used to get the current rate for which a base currency exchanges with other currencies. For example, The rate for which USD exchanges for CAD or BRL

Description

The ExchangeRatesAPI.live() method is used to communicate with this endpoint as seen below:

ExchangeRatesAPI.live(base, Optional[target])

Query Parameters

Below are the query parameters for this method:

base

string

required

The base currency to get the latest exchange rates for, e.g GBP. It must be a currency code supported by AbstractAPI.

target

string

The target currency or currencies that the base currency is converted into. A list of comma separated currency codes is also permitted, e.g “target=USD,CAD,BRL”. This will limit the response data to the specified currency codes.

Usage

Below is a code snippet to query the ExchangeRatesAPI.live() method:

from abstract_python import ExchangeRatesAPI

api_key = "your-exchange-rates-api-key"

api = ExchangeRatesAPI(api_key)
base = "GBP"
response = api.live(base)

print(response)

Below is the response object:

{
    'base': 'GBP', 
    'last_updated': 1726665300, 
    'exchange_rates': {
        'EUR': 1.191143, 
        'USD': 1.328839, 
        'JPY': 190.022989, 
        'BGN': 2.329637, 
        'CZK': 29.875049, 
        'DKK': 8.884971, 
        'HUF': 469.965338, 
        'PLN': 5.081176,
        'RON': 5.92522,
        'SEK': 13.480757, 
        'CHF': 1.126821, 
        'ISK': 181.649256, 
        'NOK': 13.898014, 
        'HRK': 8.497288, 
        'RUB': 140.714371, 
        'TRY': 45.21387, 
        'AUD': 1.947756, 
        'BRL': 7.175443, 
        'CAD': 1.799817, 
        'CNY': 9.38942, 
        'HKD': 10.357224, 
        'IDR': 20159.482091, 
        'ILS': 4.990769, 
        'INR': 111.163389, 
        'KRW': 1764.761235, 
        'MXN': 25.479733, 
        'MYR': 5.59444, 
        'NZD': 2.125594, 
        'PHP': 73.790097
    }, 
    'status': 200
}

Response Fields

base

String

The base currency used to make the request

last_updated

Integer

A Unix timestamp of when the returned data was last updated

exchange_rates

Object

A JSON object of currencies supported by AbstractAPI and their rates. Response is limited if target currencies are specified in the request.

status

Integer

The status code of the response.

Limit response data

You can limit the response data by specifying a comma-separated list of target currency codes in your query.
Below is a code snippet to limit response data:

from abstract_python import ExchangeRatesAPI

api_key = "your-exchange-rates-api-key"

api = ExchangeRatesAPI(api_key)
base = "GBP"
target = "USD,BRL,LTC"

# add "target" as a keyword argument
response = api.live(base, target)

print(response)

Below is the response object:

{
    'base': 'GBP', 
    'last_updated': 1726665300, 
    'exchange_rates': {
        'USD': 1.328839, 
        'BRL': 7.175443, 
        'LTC': 0.01834
    }, 
    'status': 200
}