https://github.com/glory42/currency_nostalgia_api

💱 A Node.js REST API for comparing real-time and historical USD exchange rates. Combines live data from CurrencyFreaks with structured JSON datasets 🗂️ to analyze product price changes over time 📊. Ideal for currency-based cost analysis, nostalgia pricing tools, and educational use cases 🧠.
https://github.com/glory42/currency_nostalgia_api

axios cron-jobs currency-exchange-rates express historical-data json nodejs price-comparison rest-api supabase time-travel

Last synced: 5 months ago
JSON representation

💱 A Node.js REST API for comparing real-time and historical USD exchange rates. Combines live data from CurrencyFreaks with structured JSON datasets 🗂️ to analyze product price changes over time 📊. Ideal for currency-based cost analysis, nostalgia pricing tools, and educational use cases 🧠.

• Host: GitHub
• URL: https://github.com/glory42/currency_nostalgia_api
• Owner: Glory42
• License: mit
• Created: 2025-04-01T20:36:24.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-05T18:53:27.000Z (about 1 year ago)
• Last Synced: 2025-06-19T17:51:47.410Z (about 1 year ago)
• Topics: axios, cron-jobs, currency-exchange-rates, express, historical-data, json, nodejs, price-comparison, rest-api, supabase, time-travel
• Language: JavaScript
• Homepage:
• Size: 49.8 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 💱 Currency Nostalgia API

Currency Nostalgia is a currency comparison API that allows users to compare historical USD exchange rates with today's product prices. It uses [CurrencyFreaks](https://currencyfreaks.com/) free API for current exchange rates and manually added JSON data for historical values and product prices.

## 🚀 Features

- Fetches live exchange rates using CurrencyFreaks API.

- Compares historical product prices with today's equivalents.

- Stores historical exchange rates and product data in local JSON files.

- Schedules daily currency rate updates using `node-cron`.

## 🔗 Live Demo (Hosted on Render)

You can test the API live on Render:

- **Get the latest exchange rates:**  

  https://webappkindathingidk.onrender.com/currency/latest

- **Compare historical vs current product price:**  

  [`https://webappkindathingidk.onrender.com/nostalgia/compare?year=2015&productId=1`](https://webappkindathingidk.onrender.com/nostalgia/compare?year=2015&productId=1)  

  ↳ You can modify `year` and `productId` to test other combinations.

## 🛠️ Project Structure

````

project-root/

├── node_modules/                  # Node.js modules

├── public/                        # Static files (CSS, JavaScript, images)

│   ├── css/

│   ├── js/

│   └── img/

├── views/                         # Frontend files (HTML, template engine files)

│   └── layouts/

├── routes/                        # Route definitions

│   ├── currency.js                

│   └── nostalgia.js               

├── controllers/                   # Route handlers

│   ├── currencyController.js      

│   └── nostalgiaController.js     

├── config/                        # API and DB configuration

│   ├── api.js

│   └── supabase.js

├── services/

│   └── exchangeRateSerices.js

├── data/                          # Data Files

│   ├── products.json              

│   └── historicalExchange.json    

├── utils/                         # Utility functions

│   └── apiUtils.js                

├── .env                           # Environment variables

├── .gitignore                     # Files to be ignored by Git

├── package.json                   # Node.js project configuration

├── server.js                      # Main server file

└── README.md                      # Project description

````

## ⚙️ Setup Instructions

Projenin çalışabilmesi için aşağıdaki adımları takip edin:

### 1. Clone the repository:

```bash

git clone https://github.com/Glory42/webAppKindaThingidk.git

cd webAppKindaThingidk

```

### 2. Install dependencies:

````bash

npm install

`````

### 3. Create a .env file:

In the project root, create a .env file with the following content:

````

CURRENCY_API_KEY=your_currencyfreaks_api_key

SUPABASE_URL=https://your-project.supabase.co

SUPABASE_KEY=your_supabase_anon_key`

````

### 4. Start the server:

````bash

npm start

````

The API will be accessible at: 

```` bash

 http://localhost:3000

```` 

## 📦 Dependencies

| Package                 | Purpose                       |

| ----------------------- | ----------------------------- |

| `express`               | Web framework                 |

| `axios`                 | HTTP client                   |

| `cors`                  | Cross-Origin Resource Sharing |

| `node-cron`             | Scheduled background tasks    |

| `@supabase/supabase-js` | Supabase client for DB access |

## 📁 Data Files

* data/products.json: Historical product prices per year.

* data/historicalExchange.json: Manually stored historical exchange rates.

## 📬 Contributing

Pull requests and contributions are welcome. Please open an issue first to discuss your ideas before making major changes.

MIT [LICENSE](LICENSE) © 2025 Görkem Karyol