{"_id":"open-exchange-rates","_rev":"13-5e44c803df6fdef1e66713424cd9c042","name":"open-exchange-rates","description":"nodeJS/npm wrapper for the Open Exchange Rates API","dist-tags":{"latest":"0.3.0"},"versions":{"0.2.0":{"name":"open-exchange-rates","description":"nodeJS/npm wrapper for the Open Exchange Rates API","homepage":"https://openexchangerates.org","keywords":["exchange","rate","rates","api","realtime","currency","conversion","money","fx","loader","utilities","accounting","forex","finance"],"author":{"name":"Joss Crowcroft","email":"josscrowcroft@gmail.com","url":"http://www.josscrowcroft.com"},"contributors":[{"name":"Joss Crowcroft","email":"josscrowcroft@gmail.com","url":"http://www.josscrowcroft.com"},{"name":"Currency Bot","url":"http://currencybot.github.com"},{"name":"Open Exchange Rates","email":"info@openxchangerates.org","url":"https://openexchangerates.org"}],"dependencies":{"http-agent":"*"},"repository":{"type":"git","url":"git://github.com/josscrowcroft/npm-exchange-rates.git"},"main":"open-exchange-rates.js","version":"0.2.0","_id":"open-exchange-rates@0.2.0","dist":{"shasum":"f5d1c0c0719f0f0424e020c4c00b9d830073af0b","tarball":"https://registry.npmjs.org/open-exchange-rates/-/open-exchange-rates-0.2.0.tgz","integrity":"sha512-V8TW9kuPalnDu/vnGBNgIDXLGNsZDS94THsPrZ++MlKj9sC8VoyxsUIqEtq36kNha0WDLOMpVvmapeE1WAem7w==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIAPgtZ7qp1+leRmmKC0rEjoFF6yQk3g/I6cttdgzRrmDAiAR6CVmssxSLzPAMRszMT0EHfkjnOVvmp6UWTYjCQ5Z2g=="}]},"maintainers":[{"name":"joss","email":"josscrowcroft@gmail.com"}]},"0.3.0":{"name":"open-exchange-rates","description":"nodeJS/npm wrapper for the Open Exchange Rates API","homepage":"https://openexchangerates.org","keywords":["exchange","rate","rates","api","realtime","currency","conversion","money","fx","loader","utilities","accounting","forex","finance"],"author":{"name":"Open Exchange Rates","email":"info@openexchangerates.org","url":"https://www.openexchangerates.org"},"contributors":[{"name":"Open Exchange Rates","email":"info@openxchangerates.org","url":"https://openexchangerates.org"},{"name":"Joss Crowcroft","email":"josscrowcroft@gmail.com","url":"http://www.josscrowcroft.com"}],"dependencies":{"http-agent":"*"},"repository":{"type":"git","url":"git://github.com/openexchangerates/npm-exchange-rates.git"},"main":"open-exchange-rates.js","version":"0.3.0","gitHead":"84a822ab9b7b907ac5e30bd435918d8eb77f5d85","bugs":{"url":"https://github.com/openexchangerates/npm-exchange-rates/issues"},"_id":"open-exchange-rates@0.3.0","scripts":{},"_shasum":"00a0f22e8a06945f60615c25656cd765fd48316b","_from":".","_npmVersion":"1.4.21","_npmUser":{"name":"joss","email":"josscrowcroft@gmail.com"},"maintainers":[{"name":"joss","email":"josscrowcroft@gmail.com"}],"dist":{"shasum":"00a0f22e8a06945f60615c25656cd765fd48316b","tarball":"https://registry.npmjs.org/open-exchange-rates/-/open-exchange-rates-0.3.0.tgz","integrity":"sha512-dxRGJ1LXbkNM1RZxcbO6XI9i+O2xduVbpb34RGspthuRC/M098gNxmReFTVJ30/3wxMk6Cp9S65eQlnP3Ye3pg==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDmF/NXJzVa0gUgplZwFtRWWSqkhNf/vECc+amURkZnzwIgMTONioiQffW7Yb6VKjHv6un2pFHA8nbyLaEgD4NjazI="}]}}},"readme":"# Open Exchange Rates npm/nodeJS module\n\nnodeJS/npm wrapper for the **[Open Exchange Rates API](http://openexchangerates.org \"Free reliable exchange rates/currency conversion data API\")** service. Loads up-to-date or historical currency/exchange rate data from the API, for seamless server-side integration.\n\nRequires a free or paid App ID to connect to the service, **[available here](https://openexchangerates.org/signup \"Open Exchange Rates API App ID API Key signup\")**.\n\n\n## Introduction\n\n\t$ npm install open-exchange-rates\n\n\nTo install, type `npm install open-exchange-rates` in the terminal.\n\nRequires: `http-agent`\n\n\n## Example Usage:\n\nSee the **example.js** script in this repository for a basic, working example.\n\n#### Load the module:\n\n\tvar oxr = require('open-exchange-rates');\n\n#### Load the latest rates from https://openexchangerates.org:\n\n\tvar oxr = require('open-exchange-rates');\n\toxr.set({ app_id: 'YOUR_APP_ID' })\n\t\n\toxr.latest(function() {\n\t\t// You can now use `oxr.rates`, `oxr.base` and `oxr.timestamp`\n\t});\n\n#### Get historical rates (\"YYYY-MM-DD\"):\n\n\tvar oxr = require('open-exchange-rates');\n\toxr.set({ app_id: 'YOUR_APP_ID' })\n\t\n\toxr.historical('2001-02-03', function() {\n\t\t// You can now use `oxr.rates`, `oxr.base` and `oxr.timestamp`\n\t});\n\n#### Currency conversion with money.js (fx) module:\n\n**[money.js](http://openexchangerates.github.io/money.js \"JavaScript and NodeJS Currency Conversion Library\")** (`npm install money`) is a tiny JavaScript currency-conversion library for web and nodeJS.\n\n\tvar oxr = require('open-exchange-rates'),\n\t\tfx = require('money');\n\t\n\toxr.set({ app_id: 'YOUR_APP_ID' })\n\t\n\toxr.latest(function() {\n\t\t// Apply exchange rates and base rate to `fx` library object:\n\t\tfx.rates = oxr.rates;\n\t\tfx.base = oxr.base;\n\t\t\n\t\t// money.js is ready to use:\n\t\tfx(100).from('HKD').to('GBP'); // ~8.0424\n\t});\n\n#### Advanced API Features:\n\nAdvanced API features (such as Time Series requests and real-time value conversion) will be added to this module in future.\n\n\n## More Info\n\nFor more information, documentation, examples and showcase, check out the **[Open Exchange Rates homepage](https://openexchangerates.org \"Open Exchange Rates API - real-time currency data API\")**\n\n\n## Roadmap\n\n* Support HTTPS connections\n* Support advanced API queries/features\n* Support Time Series data requests\n* Support `Date` objects for historical queries\n\n\n## Changelog\n\n**0.3**\n* Now maintained by openexchangerates.org\n* Tidied up library, readme and example\n\n**0.2**\n* Updated to work with Open Exchange Rates App IDs\n* Renamed to 'open-exchange-rates'\n\n**0.1** - first version\n","maintainers":[{"name":"openexchangerates","email":"info@openexchangerates.org"}],"time":{"modified":"2022-06-22T23:12:06.664Z","created":"2012-10-29T17:09:10.434Z","0.2.0":"2012-10-29T17:09:14.329Z","0.3.0":"2014-07-16T12:44:47.771Z"},"author":{"name":"Open Exchange Rates","email":"info@openexchangerates.org","url":"https://www.openexchangerates.org"},"repository":{"type":"git","url":"git://github.com/openexchangerates/npm-exchange-rates.git"},"homepage":"https://openexchangerates.org","keywords":["exchange","rate","rates","api","realtime","currency","conversion","money","fx","loader","utilities","accounting","forex","finance"],"contributors":[{"name":"Open Exchange Rates","email":"info@openxchangerates.org","url":"https://openexchangerates.org"},{"name":"Joss Crowcroft","email":"josscrowcroft@gmail.com","url":"http://www.josscrowcroft.com"}],"bugs":{"url":"https://github.com/openexchangerates/npm-exchange-rates/issues"},"readmeFilename":"readme.md","users":{"joss":true,"nanook":true,"koslun":true,"hckhanh":true}}