https://github.com/sachinkalsi/currency-api
Currency Converter API
https://github.com/sachinkalsi/currency-api
currency-api currency-conversion currency-converter currency-exchange currency-exchange-rates
Last synced: 3 months ago
JSON representation
Currency Converter API
- Host: GitHub
- URL: https://github.com/sachinkalsi/currency-api
- Owner: SachinKalsi
- Created: 2018-10-22T16:20:07.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-09-25T05:42:30.000Z (about 3 years ago)
- Last Synced: 2025-03-02T02:46:39.984Z (7 months ago)
- Topics: currency-api, currency-conversion, currency-converter, currency-exchange, currency-exchange-rates
- Language: JavaScript
- Homepage: https://free-currency-converter.herokuapp.com/
- Size: 18.6 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# currency-api
API for currency conversion
## Getting Started
1. Sign up for [currencylayer](https://currencylayer.com/signup?plan=1) & get the access-key
2. Set up the environmental variables in `.env` file
2. npm install
3. npm start
4. Go the browser & type http://localhost:3000 (depending on the port number you specified in `.env` file)
### Prerequisites
1. Node JS ( Any version > 5.0.0)
2. NPM (Any version 3.8.0)
3. MongoDB
## Built With
* [Node](https://nodejs.org) - A JavaScript runtime built on Chrome's V8 JavaScript engine
* [Express](https://expressjs.com) - A web framework for Node.js
* [MongoDB](https://www.mongodb.com/) - NoSQL database
## API Endpoints
1. **[GET - currency list](https://free-currency.herokuapp.com/list)**
2. **[GET - currency conversion](https://free-currency.herokuapp.com/list/convert?source=USD&destination=INR)**
Please refer [here](https://free-currency.herokuapp.com/#api-details) for detailed documentation
**_P.S: The real-time currency rates are updated every one minute_**
## Valid Currencies
`AED`,`AFN`,`ALL`,`AMD`,`ANG`,`AOA`,`ARS`,`AUD`,`AWG`,`AZN`,`BAM`,`BBD`,`BDT`,`BGN`,`BHD`,`BIF`,`BMD`,`BND`,`BOB`,`BRL`,`BSD`,`BTC`,`BTN`,`BWP`,`CRC`,`CUC`,`CUP`,`CVE`,`CZK`,`DJF`,`DKK`,`DOP`,`DZD`,`EEK`,`EGP`,`ERN`,`ETB`,`EUR`,`FJD`,`FKP`,`GBP`,`GEL`,`GGP`,`GHS`,`GIP`,`GMD`,`GNF`,`GTQ`,`GYD`,`HKD`,`HNL`,`HRK`,`HTG`,`HUF`,`IDR`,`ILS`,`IMP`,`INR`,`IQD`,`IRR`,`ISK`,`JEP`,`JMD`,`JOD`,`JPY`,`KES`,`KGS`,`KHR`,`KMF`,`KPW`,`KRW`,`KWD`,`KYD`,`KZT`,`LAK`,`LBP`,`LKR`,`LRD`,`LSL`,`LTL`,`LVL`,`LYD`,`MAD`,`MDL`,`MGA`,`MKD`,`MMK`,`MNT`,`MOP`,`MRO`,`MUR`,`MVR`,`MWK`,`MXN`,`MYR`,`MZN`,`NAD`,`NGN`,`NIO`,`NOK`,`NPR`,`NZD`,`OMR`,`PAB`,`PEN`,`PGK`,`PHP`,`PKR`,`PLN`,`PYG`,`QAR`,`RON`,`RSD`,`RUB`,`RWF`,`SAR`,`SBD`,`SCR`,`SDG`,`SEK`,`SGD`,`SHP`,`SLL`,`SOS`,`SRD`,`STD`,`SVC`,`SYP`,`SZL`,`THB`,`TJS`,`TMT`,`TND`,`TOP`,`TRY`,`TTD`,`TWD`,`TZS`,`UAH`,`UGX`,`USD`,`UYU`,`UZS`,`VEF`,`VND`,`VUV`,`WST`,`XAF`,`XAG`,`XAU`,`XCD`,`XDR`,`XOF`,`XPF`,`YER`,`ZAR`,`ZMK`,`ZMW`,`ZWL`,`BYN`,`BYR`,`BZD`,`CAD`,`CDF`,`CHF`,`CLF`,`CLP`,`CNY `,`COP`
*_Update_*: The heroku app link (https://free-currency-converter.herokuapp.com/) might not work. The heroko has made some restrictions on free dynos