x-rates APIx-rates.com ↗

"""XRates API — currency exchange rates, conversion, and trend data."""
from parse_apis.xrates_api import XRates, From, CurrencyNotFound

client = XRates()

# List all supported currencies
currencies = client.currencylists.get()
print(f"Supported currencies: {currencies.count}")
for c in currencies.currencies[:3]:
    print(f"  {c.code}: {c.name}")

# Get current exchange rates for USD using the From enum
table = client.ratestables.current(from_currency=From.USD)
print(f"\nRates from {table.base_currency} (as of {table.timestamp}):")
for rate in table.rates[:3]:
    print(f"  {rate.code}: {rate.rate} (inverse: {rate.inverse_rate})")

# Convert currency
conversion = client.conversions.convert(from_currency=From.USD, to_currency=From.EUR, amount=1000)
print(f"\n{conversion.amount} {conversion.from_currency} = {conversion.converted_value} {conversion.to_currency}")
print(f"  Result text: {conversion.result_text}")

# Get historical rates for a past date
historical = client.ratestables.historical(date="2024-06-01", from_currency=From.EUR)
print(f"\nHistorical rates on 2024-06-01 from {historical.base_currency}:")
for rate in historical.rates[:3]:
    print(f"  {rate.code}: {rate.rate}")

# Monthly averages for a currency pair
averages = client.monthlyaverageresults.get(from_currency=From.USD, to_currency=From.GBP, year="2024")
print(f"\nMonthly USD→GBP averages for {averages.year}:")
for avg in averages.monthly_averages[:3]:
    print(f"  {avg.month}: {avg.average_rate} ({avg.days})")

# Graph trend data
graph = client.graphresults.get(from_currency=From.USD, to_currency=From.JPY)
print(f"\nUSD→JPY trend ({graph.from_currency}→{graph.to_currency}):")
for dp in graph.data_points[:3]:
    print(f"  {dp.label}: {dp.rate}")

# 24-hour market trends
snapshot = client.trendsnapshots.get()
print(f"\n24h trends (as of {snapshot.timestamp}):")
for trend in snapshot.trends[:3]:
    print(f"  {trend.pair}: {trend.change} ({trend.direction})")

# Error handling — catch not-found for invalid currency
try:
    client.conversions.convert(from_currency="INVALID", to_currency=From.EUR)
except CurrencyNotFound as exc:
    print(f"\nCurrency not found: {exc}")

print("\nExercised: currencylists.get / ratestables.current / ratestables.historical / conversions.convert / monthlyaverageresults.get / graphresults.get / trendsnapshots.get")