AbstractAPI javascript-exchange-rates library

Integrate the powerful Exchange Rates API from Abstract in your Javascript or NodeJS project in a few lines of code.

The Exchange Rate API is an REST API that allows you to:

- look up the latest exchange rates for 80+ currencies via the live endpoint
- get historical exchange rates using the historical endpoint
- convert an arbitrary amount from one currency to another using the convert endpoint

It's very simple to use: you only need to submit your API key and a currency symbole (such as "USD"), and the API will respond with current exchange rate, historical data, or convertion rates.

Documentation

Installation

You can install javascript-exchange-rates via npm, from our CDN, or download the source into your project.

$3

Download and install the library from npm:

``
npm install @abstractapi/javascript-exchange-rates --save
`

In your project, import it and configure your API_KEY:

`js
import {AbstractExchangeRates} from 'javascript-exchange-rates'

AbstractExchangeRates.configure('API_KEY')
`

$3

You can have the browser download the library from its closest location through jsDeliver CDN:

`js



`

$3

You can build the library yourself, or get the already built file from the dist directory and load it:

`js


`

API key

Get your API key for free and without hassle from the Abstact website.

Quickstart

AbstractAPI javascript-exchange-rates library returns a Promise so you can use one of the following approaches:

$3

`js
async function getLiveRates(currency) {
let response = await AbstractExchangeRates.live(currency);
console.log(response);
}

async function getHistoricalRates(currency, date) {
let response = await AbstractExchangeRates.historical(currency, date);
console.log(response);
}

async function getConvertion(currency, target) {
let response = await AbstractExchangeRates.convert(currency, target);
console.log(response);
}
`

$3

`js
function getLiveRates(currency) {
AbstractExchangeRates.live(currency)
.then(response => {
console.log(response);
})
}

function getHistoricalRates(currency, date) {
AbstractExchangeRates.historical(currency, date)
.then(response => {
console.log(response);
})
}

function getConvertion(currency, target) {
AbstractExchangeRates.convert(currency, target)
.then(response => {
console.log(response);
})
}
`

API response

The API response contains the following fields:

$3

Run npm install in the command line to install the dependencies. To update those dependencies you need to run npm update.

$3

To build the library and generate the minified file in the dist directory, you need to run npm run build.

To build the lib, you need to run npm run build:lib`.

$3

To run the test suite, you need the API key from the abstract website and you can run:

EXCHANGE_RATES_API_KEY=(your key here) npm run test