Skip to content
/ curls.top Public

curls: UAH exchange rates simply put into Your shell

License

Notifications You must be signed in to change notification settings

ybod/curls.top

Repository files navigation

curls.top

This simple web app allows You to get actual UAH/USD and UAH/EUR exchange rates delivered directly into Your shell via curl or similar command line tools (wget, HTTPie).

Usage

You can access this app from a shell via curl curls.top command:

Shell output screenshot

Some details

  1. App can return weekly history of UAH/USD and UAH/EUR exchange rates as ANSI escaped text on request of shell tools like curls or HTTPie
  2. App uses following sources to get information:
  1. Rates are updated every 15 minutes, Redis is used as a storage

Installation

To deploy this app locally You will need:

  1. Clone project repository
  2. Install Node.js
  3. Install project dependencies via npm install
  4. Request API Key from Minfin
  5. Set environment variable export MINFIN_KEY=[Your_unique_key]
  6. Install and start Redis
  7. Start app via Node (pm2 etc...): node app.js
  8. App will listen to 52190 port on localhost
  9. App will download actual exchange rates in 15 min
  10. You can request data from the app via curl localhost:52190 shell command

ToDo:

  1. FrontEnd :)
  2. Suggestions?