Backend-oriented Task

This project is a simple runnable local server that exposes endpoints to query data from the Narodowy Bank Polski's public APIs and return relevant information. It provides the following operations:

1. Get average exchange rate for a given date and currency code.

2. Get maximum and minimum average exchange rate for a given currency code and number of last quotations.

3. Get the major difference between the buy and ask rate for a given currency code and number of last quotations.

Demo

Desktop.2023.04.26.-.23.24.57.03.mp4

Technology Stack

• Java 17
• Spring 3.0.6
• Angular 15.2.7

Starting the Application

1. Clone the repository:

   git clone https://github.com/Krystian030/nbp-api

2. Run the following command to build and start the application using docker-compose

   docker compose up --build

Endpoints

The following endpoints are available:

1. Get the list of currency codes for a given table:

   • Endpoint: http://localhost:8080/api/exchange-rate/{table}/codes
   • Method: GET

2. Get the average exchange rate for a specific currency and date:

   • Endpoint: http://localhost:8080/api/exchange-rate/{currencyCode}/{date}
   • Method: GET

3. Get the maximum and minimum average exchange rate for a specific currency and number of last quotations:

   • Endpoint: http://localhost:8080/api/exchange-rate/{currencyCode}/max-min-average-value?numberOfLastQuotations=number
   • Method: GET

4. Get the major difference between the buy and ask rate for a specific currency and number of last quotations:

   • Endpoint: http://localhost:8080/api/exchange-rate/{currencyCode}/major-rate-difference?numberOfLastQuotations=number
   • Method: GET

Swagger API Documentation

The Swagger UI is available for this application at http://localhost:8080/swagger-ui/index.html.