exchangerateapi-js

A minimal JavaScript wrapper for exchangerateapi.net providing convenient access to the two endpoints.

• Website: exchangerateapi.net

Installation

npm install @exchangerateapinet/exchangerateapi-js

Usage

const { ExchangeRateApiClient } = require('@exchangerateapinet/exchangerateapi-js');

Or directly from src in this repo for local testing:

const { ExchangeRateApiClient } = require('./src/index');

Instantiate

const client = new ExchangeRateApiClient({ apiKey: process.env.EXCHANGERATEAPI_KEY });

Endpoints

• Latest: retrieves the latest rates for a base currency, optional symbols filter.
• Historical: retrieves historical rates for a date, base currency, optional symbols filter.

Examples

Run with an API key in your environment:

EXCHANGERATEAPI_KEY=your_api_key node examples/latest.js
EXCHANGERATEAPI_KEY=your_api_key node examples/historical.js

Latest

const latestUsd = await client.getLatest({ base: 'USD' });
const latestEurSubset = await client.getLatest({ base: 'EUR', symbols: ['USD', 'GBP', 'JPY'] });

Historical

const histUsd = await client.getHistorical({ date: '2024-01-02', base: 'USD' });
const histEurSubset = await client.getHistorical({ date: '2024-01-02', base: 'EUR', symbols: ['USD', 'GBP', 'JPY'] });

License

MIT