Simple python api wrapper for exchangeratesapi.io
Project description
python-exchangeratesapi
This is an unofficial wrapper for the awesome, free ExchangeRatesAPI, which provides exchange rate lookups courtesy of the European Central Bank.
Installation
Either clone this repository into your project, or install with pip
:
pip install python-exchangeratesapi
Usage
from exchangeratesapi import Api
api = Api()
print('Get the latest foreign exchange rates:\n%s' % api.get_rates())
print('\nGet historical rates for any day since 1999:\n%s' %
api.get_rates(start_date="2018-03-26"))
print(
'\nQuote against a different currency:\n%s' %
api.get_rates('USD')
)
print(
'\nGet historical rates for a time period:\n%s' %
api.get_rates(start_date="2018-01-01", end_date="2018-01-03")
)
print(
'\nLimit results to specific exchange rates to save bandwidth:\n%s' %
api.get_rates(target_list=['ILS', 'JPY'], start_date="2018-01-01",
end_date="2018-01-03")
)
print(
'\nQuote the historical rates against a different currency:\n%s' %
api.get_rates('USD', start_date="2018-01-01", end_date="2018-01-03")
)
print(
'\nQuote the historical rates against for specific currency with custom base currency:\n%s' %
api.get_rates('USD', ['ILS', 'JPY', 'EUR', 'RUB'], start_date="2018-01-01",
end_date="2018-01-03")
)
print('Get the latest foreign exchange rate for EUR and USD:\n%s' %
api.get_rate())
print('Get the latest foreign exchange rate for a specific currency:\n%s' %
api.get_rate(target='GBP'))
print('\nGet historical rate for any day since 1999:\n%s' %
api.get_rate(target='GBP', start_date="2018-03-26"))
print(
'\nQuote against a different currency:\n%s' %
api.get_rate('USD', 'GBP')
)
print(
'\nGet historical rate for a time period:\n%s' %
api.get_rate(target='GBP', start_date="2018-01-01", end_date="2018-01-03")
)
print(
'\nQuote the historical rates against a different currency:\n%s' %
api.get_rate('USD', target='CHF', start_date="2018-01-01",
end_date="2018-01-03")
)
This will output:
Get the latest foreign exchange rates:
{'rates': {'CAD': 1.5579, 'HKD': 8.8071, 'ISK': 145.7, 'PHP': 57.383, 'DKK': 7.4726, 'HUF': 335.46, 'CZK': 25.77, 'AUD': 1.7389, 'RON': 4.8213, 'SEK': 10.7238, 'IDR': 16269.99, 'INR': 83.5215, 'BRL': 5.2874, 'RUB': 81.3785, 'HRK': 7.5745, 'JPY': 118.55, 'THB': 35.584, 'CHF': 1.0591, 'SGD': 1.5741, 'PLN': 4.318, 'BGN': 1.9558, 'TRY': 7.0236, 'CNY': 7.8801, 'NOK': 10.8558, 'NZD': 1.7951, 'ZAR': 18.21, 'USD': 1.1336, 'MXN': 23.9025, 'ILS': 4.0316, 'GBP': 0.8769, 'KRW': 1348.07, 'MYR': 4.8002}, 'base': 'EUR', 'date': '2020-03-11'}
Get historical rates for any day since 1999:
{'rates': {'CAD': 1.5997, 'HKD': 9.7384, 'ISK': 121.9, 'PHP': 64.82, 'DKK': 7.4482, 'HUF': 312.73, 'CZK': 25.446, 'AUD': 1.6048, 'RON': 4.6593, 'SEK': 10.1868, 'IDR': 17045.27, 'INR': 80.5105, 'BRL': 4.0932, 'RUB': 70.6897, 'HRK': 7.442, 'JPY': 130.47, 'THB': 38.66, 'CHF': 1.1739, 'SGD': 1.6274, 'PLN': 4.23, 'BGN': 1.9558, 'TRY': 4.9464, 'CNY': 7.7924, 'NOK': 9.5613, 'NZD': 1.7029, 'ZAR': 14.4937, 'USD': 1.2411, 'MXN': 22.8777, 'ILS': 4.3317, 'GBP': 0.87248, 'KRW': 1336.99, 'MYR': 4.8425}, 'base': 'EUR', 'date': '2018-03-26'}
Quote against a different currency:
{'rates': {'CAD': 1.38113879, 'HKD': 7.7816725979, 'ISK': 132.2419928826, 'PHP': 51.2855871886, 'DKK': 6.6483096085, 'HUF': 301.0409252669, 'CZK': 23.3122775801, 'GBP': 0.7884608541, 'RON': 4.2894128114, 'SEK': 9.6926156584, 'IDR': 14620.9964412811, 'INR': 74.2597864769, 'BRL': 4.9004448399, 'RUB': 74.7583629893, 'HRK': 6.7615658363, 'JPY': 103.9501779359, 'THB': 31.6601423488, 'CHF': 0.9385231317, 'EUR': 0.8896797153, 'MYR': 4.265480427, 'BGN': 1.7400355872, 'TRY': 6.2598754448, 'CNY': 7.0175266904, 'NOK': 10.1140569395, 'NZD': 1.6168149466, 'ZAR': 16.4098754448, 'USD': 1.0, 'MXN': 22.0665480427, 'SGD': 1.4038256228, 'AUD': 1.5724199288, 'ILS': 3.6395907473, 'KRW': 1209.4306049822, 'PLN': 3.8789145907}, 'base': 'USD', 'date': '2020-03-12'}
Get historical rates for a time period:
{'rates': {'2018-01-03': {'CAD': 1.5047, 'HKD': 9.3985, 'SGD': 1.5988, 'PHP': 59.988, 'DKK': 7.4442, 'HUF': 309.29, 'CZK': 25.545, 'AUD': 1.5339, 'RON': 4.6355, 'SEK': 9.825, 'IDR': 16176.95, 'INR': 76.3455, 'BRL': 3.9236, 'RUB': 69.0962, 'HRK': 7.441, 'JPY': 134.97, 'THB': 39.11, 'CHF': 1.1736, 'PLN': 4.1652, 'BGN': 1.9558, 'TRY': 4.5303, 'CNY': 7.8168, 'NOK': 9.744, 'NZD': 1.6942, 'ZAR': 14.8845, 'USD': 1.2023, 'MXN': 23.3835, 'ILS': 4.1588, 'GBP': 0.8864, 'KRW': 1281.39, 'MYR': 4.8272}, '2018-01-02': {'CAD': 1.5128, 'HKD': 9.4283, 'SGD': 1.6031, 'PHP': 60.132, 'DKK': 7.4437, 'HUF': 308.59, 'CZK': 25.494, 'AUD': 1.5413, 'RON': 4.6525, 'SEK': 9.8283, 'IDR': 16266.03, 'INR': 76.6005, 'BRL': 3.9504, 'RUB': 69.1176, 'HRK': 7.464, 'JPY': 135.35, 'THB': 39.115, 'CHF': 1.1718, 'PLN': 4.1633, 'BGN': 1.9558, 'TRY': 4.534, 'CNY': 7.8338, 'NOK': 9.7748, 'NZD': 1.6955, 'ZAR': 14.9, 'USD': 1.2065, 'MXN': 23.5534, 'ILS': 4.1693, 'GBP': 0.88953, 'KRW': 1281.59, 'MYR': 4.8495}}, 'start_at': '2018-01-01', 'base': 'EUR', 'end_at': '2018-01-03'}
Limit results to specific exchange rates to save bandwidth:
{'rates': {'2018-01-03': {'JPY': 134.97, 'ILS': 4.1588}, '2018-01-02': {'JPY': 135.35, 'ILS': 4.1693}}, 'start_at': '2018-01-01', 'base': 'EUR', 'end_at': '2018-01-03'}
Quote the historical rates against a different currency:
{'rates': {'2018-01-03': {'CAD': 1.251517924, 'HKD': 7.8171005573, 'USD': 1.0, 'PHP': 49.8943691258, 'DKK': 6.191632704, 'HUF': 257.2486068369, 'CZK': 21.2467770107, 'GBP': 0.7372535973, 'RON': 3.8555269068, 'SEK': 8.1718373118, 'IDR': 13455.0029110871, 'INR': 63.4995425435, 'BRL': 3.2634117941, 'RUB': 57.470015803, 'HRK': 6.1889711387, 'JPY': 112.2598353156, 'THB': 32.5293188056, 'CHF': 0.9761290859, 'EUR': 0.8317391666, 'MYR': 4.014971305, 'BGN': 1.626715462, 'TRY': 3.7680279464, 'CNY': 6.5015387175, 'NOK': 8.1044664393, 'NZD': 1.409132496, 'ZAR': 12.3800216252, 'MXN': 19.4489728021, 'SGD': 1.3297845796, 'AUD': 1.2758047076, 'ILS': 3.459036846, 'KRW': 1065.7822506862, 'PLN': 3.4643599767}, '2018-01-02': {'CAD': 1.2538748446, 'HKD': 7.8145876502, 'USD': 1.0, 'PHP': 49.8400331538, 'DKK': 6.1696643183, 'HUF': 255.772896809, 'CZK': 21.1305428927, 'GBP': 0.7372813925, 'RON': 3.8561956071, 'SEK': 8.1461251554, 'IDR': 13481.9975134687, 'INR': 63.4898466639, 'BRL': 3.2742644012, 'RUB': 57.2876916701, 'HRK': 6.1864898467, 'JPY': 112.1840033154, 'THB': 32.4202237878, 'CHF': 0.9712391214, 'EUR': 0.828843763, 'MYR': 4.0194778284, 'BGN': 1.6210526316, 'TRY': 3.7579776212, 'CNY': 6.4929962702, 'NOK': 8.1017820141, 'NZD': 1.4053046001, 'ZAR': 12.349772068, 'MXN': 19.5220886863, 'SGD': 1.3287194364, 'AUD': 1.2774968918, 'ILS': 3.4556983009, 'KRW': 1062.23787816, 'PLN': 3.4507252383}}, 'start_at': '2018-01-01', 'base': 'USD', 'end_at': '2018-01-03'}
Quote the historical rates against for specific currency with custom base currency:
{'rates': {'2018-01-03': {'EUR': 0.8317391666, 'JPY': 112.2598353156, 'RUB': 57.470015803, 'ILS': 3.459036846}, '2018-01-02': {'EUR': 0.828843763, 'JPY': 112.1840033154, 'RUB': 57.2876916701, 'ILS': 3.4556983009}}, 'start_at': '2018-01-01', 'base': 'USD', 'end_at': '2018-01-03'}
Get the latest foreign exchange rate for EUR and USD:
1.124
Get the latest foreign exchange rate for a specific currency:
0.88623
Get historical rate for any day since 1999:
0.87248
Quote against a different currency:
0.7884608541
Get historical rate for a time period:
{'2018-01-03': {'GBP': 0.8864}, '2018-01-02': {'GBP': 0.88953}}
Quote the historical rates against a different currency:
{'2018-01-03': {'CHF': 0.9761290859}, '2018-01-02': {'CHF': 0.9712391214}}
Supported currencies
The list of currencies can be found at European Central Bank's data set.
If your currency is not in the list, then the library will be of not use to you. You may try openexchangerates.org API or some other service.
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for python-exchangeratesapi-0.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4b457585f63f3a6d4b3d416fabf96118f03e31bf503403287182e9bd2db8b81b |
|
MD5 | a5d6934dc362259bb24f18845d83d368 |
|
BLAKE2b-256 | aa337691de47a555bc38d70044161ac3ed89631a1e59dbde59a546d34096fc92 |
Close
Hashes for python_exchangeratesapi-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3787654a9f94c0a47cbfe68fe7f0b6506a69b044ca7d248ec00832a42aa27cf2 |
|
MD5 | 3d0f1fd67155c669d9ea1898929197ca |
|
BLAKE2b-256 | 15f600f7dab8e231072dd77274858678ee3c63b269583cf5c017577d3e8e01be |