currencylayer-client

baldercm/currencylayer-client

A nodejs client to consume the CurrencyLayer API for exchange rates & currency conversion.

See https://currencylayer.com/documentation for further details.

Installation

Install the module using npm:

npm i --save currencylayer-client

Basic Usage

You can instantiate the client passing your API key:

const CurrencyLayerClient = require('currencylayer-client')

// for FREE plans, will use HTTP endpoints
let client = new CurrencyLayerClient({apiKey: 'YOURAPIKEY'})

// for NON FREE plans, will use HTTPS endpoints
let client = new CurrencyLayerClient({apiKey: 'YOURAPIKEY', free: false})

All client mehtods return:

• a promise resolved with the full response for success=true responses
• a promise rejected with an error holding the code and info for success=false responses

live({currencies, source})

Will get the live rate for the given currencies and source.

All parameters are optional.

Remember source param is only available for non-free plans.

client.live()

// currencies as string
client.live({currencies: 'GBP,USD', source: 'EUR'})

// currencies as array
client.live({currencies: ['GBP', 'USD'], source: 'EUR'})

historical({date, currencies, source})

Will get the historical rate for the given date, currencies and source.

All parameters are optional.

Remember source param is only available for non-free plans.

// date default to current day
client.historical()

// currencies as string, date as string
client.historical({date: '2000-01-01', currencies: 'GBP,USD', source: 'EUR'})

// currencies as array, date as date
client.historical({date: new Date(2000, 0, 1), currencies: ['GBP', 'USD'], source: 'EUR'})

convert({from, to, amount, date})

Will convert the given amount.

from, to and amount are required, date is optional.

Remember convert() is only available for non-free plans.

// date default to current day
client.convert({from: 'EUR', to: 'USD', amount: 10})

// date as string
client.convert({date: '2000-01-01', from: 'EUR', to: 'USD', amount: 10})

// date as date
client.convert({date: new Date(2000, 0, 1), from: 'EUR', to: 'USD', amount: 10})

Contributing

git clone https://github.com/baldercm/currencylayer-client
npm install
npm test
npm run lint

License

MIT