
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
