top of page

Currency Converter – Java + ExchangeRate API

Console application developed in Java 17 using Maven.
The project consumes the ExchangeRate API to obtain real-time FX rates and converts values between multiple currencies (USD, ARS, BRL, COP).
It is part of my backend training path and replicates a realistic workflow: API integration, JSON processing, domain logic and packaging the app as an executable JAR.

Responsibilities

  • Design of the conversion flow and menu-driven CLI.

  • Integration with ExchangeRate API (HTTP client + API key handling).

  • JSON parsing with Gson and mapping response fields.

  • Error handling for network issues, invalid input and malformed JSON.

  • Maven configuration, dependency management and JAR packaging.
     

Tech Stack

  • Language: Java 17

  • Build tool: Maven

  • HTTP client: java.net.http.HttpClient / HttpRequest / HttpResponse

  • JSON: Gson (JsonParser, JsonObject)

  • Config: .properties file for API key

  • Version control: Git + GitHub
     

Features

  • Real-time FX conversion using ExchangeRate API.

  • Supported pairs:

    • USD ⇄ ARS

    • USD ⇄ BRL

    • USD ⇄ COP

  • Text-based interactive menu with Scanner.

  • Clear error messages for invalid options and input values.

  • API key loaded securely from config.properties (not hard-coded).
     

How to Run

# 1. Clone the repository

git clone https://github.com/locampocam/conversor-monedas.git

cd conversor-monedas

 

# 2. Create src/main/resources/config.properties with your API key

# API_KEY=your_api_key_here

 

# 3. Build the executable JAR

mvn clean package

 

# 4. Run the application

java -jar target/conversor-monedas-1.0-SNAPSHOT.jar

Project Gallery

Previous
Next
  • Whatsapp
  • Instagram
  • LinkedIn
  • Youtube
  • TikTok
  • GitHub

© 2035 Laura Ocampo Campo · Art, Technology, and Culture

bottom of page